Manual Redirection
Integration Guide

INTEGRATION MANUAL

The following document has been designed to make thedisbursement API integration swift and easy, making sure possiblecase scenarios are covered with sample codes and guides.

Introduction​

Make Your Transactions Quick and Easy. Experience fast, secure, andhassle-free payments with AssanPay designed to simplify your
financial transactions anytime, anywhere.

Cross-Browser

Assan Pay ensures seamless performance across all major web browsers,providing a consistent and reliable user experience for everyone.

Amazing Features

Secure, fast, and user-friendly payment solutions all in one platform.

Easy Payment

Simplify transactions with secure and hassle-free payments

Workflow Is What We Do

  • Trusted Company

Simplify transactions with secure and hassle-free payments

  • Fast Support

Quick and reliable assistance whenever you need it.

  • Fast Process

Swift and seamless transactions every time.

  • Easy to Use

Intuitive and simple payment solutions for everyone.

  • Take It Anywhere

Access seamless payments on the go, anytime, anywhere.

Redirect User to Payment Page (Redirectional/Cashier Model)

POST

				
					POST payment-request/qr/{merchantId}

Initiate a Payment Request

This API endpoint is used to initiate a payment request by generating a unique payment link. Theclient (merchant) sends the order details (amount, store name, and order ID), and the API
responds with a manage-payments URL, which can be shared with users for completing thepayment.This is ideal for generating dynamic links for customer payments.

Base URL

https://api.assanpay.com/

Endpoint: Initiate a Payment Request 

				
					POST payment-request/qr/{merchantId}

Initiate a payment request by generating a unique payment link.

Full Example:

POST

				
					https://api.assanpay.com/payment-request/qr/{merhnatId}

Parameters

[table id=19 /]

Request Body

[table id=20 /]

Example

				
					{
"amount": "10",
"order_id": "12340", // must be unique
"store_name": "Your store"
"link": "google.com"
}

Responses

[table id=24 /]

Successful Response: 

				
					{
"status": "true",
"message": "Payment request created successfully",
"data": {
"id": "ddc6b617-3126-4866-9782-c68f535034b6",
"transactionId": "T202512181151100kr4f",
"amount": "10",
"description": "null",
"dueDate": "null",
"status": "pending",
"link": "/pay/ddc6b617-3126-4866-9782-c68f535034b6",
"metadata": {
“return_url: “yourUrl.com”
},
"provider": "null",
"userId": "5",
"createdAt": "2025-12-18T06:51:10.839Z",
"updatedAt": "2025-12-18T06:51:10.848Z",
"deletedAt": "null",
"merchant_transaction_id": "12340",
"completeLink": "https://merchant.assanpay.com/aik-qr/ddc6b617-3126-4866-9782-c68f535034b6"
"order_id": "12340"
},
}

Note:

You should focus on the completeLink parameter in the response body for redirecting the user tothepayment page

Failure Responses:

Example failure 200 Order Id already exists

				
					{
"success": "true
"message": "Order Id already exists"
"data": "{}"
"statusCode": "200"
}

Example failure 500 Internal Server Error (Required field missing)

				
					{
"statusText": "error",
"status": 400,
"message": "\nInvalid `prisma.paymentRequest.create()`
invocation:\n\n{\ndata: {\n userId: 522,\n status: \"pending\",\nemail:\"example@example.com\",\n description: \"Clone payment requesttest\",\ntransactionId: \"T202505262028570staz\",\n dueDate: \"2025-06-01T00:00:00.000Z\",\n provider: \"Easypaisa\",\n link: \"\",\n metadata:{\norderNumber: \"order_clone_7856909\"\n },\n createdAt: newDate(\"2025-05-27T09:53:36.312Z\"),\n updatedAt: new Date(\"2025-05-27T09:53:36.312Z\"),\nmerchant_transaction_id: \"445u08755i45ii78-CLONE01\",\n+ amount:Decimal\n }\n}\n\nArgument `amount` is missing."
}

Example failure 400 Transaction Not Created 

				
					{
"statusText": "fail",
"status": "400",
"message": "Transaction not Created"
}

Example failure 500 Internal Server Error 

				
					{
"status": "error",
"message": "Something went wrong"
}

GET

				
					GET payment/all-inquiry/

Status Inquiry

This endpoint allows you to inquire about the payment status of the payment using the order ID.

Base URL

https://api.assanpay.com/

Endpoint: Status Inquiry 

				
					GET /payment/all-inquiry/

Retrieve the status of a payment.

Full Example:

POST

				
					https://api.assanpay.com/payment/all-inquiry/%7BmerchnatId%7D?transactionId=orderId

Note: Replace transactionId with the actual order ID in the URL.

Parameters

[table id=22 /]

No Request Body

Responses

[table id=23 /]

Successful Response:

				
					{
"status": "true",
"message": "Payment status retrieved successfully"
"data": {
"orderId": "12340",
"transactionStaus": "Pending",
"transactionAmount": ”10”,
"transactionDateTime": “2025-12-18T06:51:10.836Z”,"responseDesc": null,
"responseMode": "MA",
},
}

Example failure 404 ( Payment Data Not Found )

				
					{
"status": "error",
"message": "Failed to retrieve payout status",
"data": {
"status": 404,
"message": "Payment data not found",
"errcode": "validation"
}
}