Header Name | Header Value |
---|---|
| application/json |
| SHA256(base64 encoded payload + "/v4/debit" + |
| Dynamic redirect URI for UI callback |
| HTTP mode to be used for UI callback |
| Dynamic callback URI for server to server callback |
| HTTP mode to be used for server to server callback |
| Used for the cases where the merchant has multiple merchant IDs |
{
"merchantId": "UATMERCHANT",
"transactionId": "TX123456789",
"merchantUserId": "U123456789",
"amount": 100,
"merchantOrderId": "OD1234",
"mobileNumber": "9xxxxxxxxx",
"message": "payment for order placed OD1234",
"subMerchantId": "DemoMerchant",
"email": "amit***[email protected]",
"shortName": "Amit",
"gstBreakup": {
"gst": 100,
"cgst": 25,
"cess": 25,
"sgst": 25,
"igst": 25,
"gstIncentive": 100,
"gstPercentage": 10
},
"invoiceDetails": {
"invoiceNumber": "123456fffff##_##",
"invoiceDate": "2021-06-29T10:13:54.022Z",
"invoiceName": "bccbd_cjdcdjc******"
}
}
{
"request": "ewogICJtZXJjaGFudElkIjogIlVBVE1FUkNIQU5UIiwKICAidHJhbnNhY3Rpb25JZCI6ICJUWDEyMzQ1Njc4OSIsCiAgIm1lcmNoYW50VXNlcklkIjogIlUxMjM0NTY3ODkiLAogICJhbW91bnQiOiAxMDAsCiAgIm1lcmNoYW50T3JkZXJJZCI6ICJPRDEyMzQiLAogICJtb2JpbGVOdW1iZXIiOiAiOXh4eHh4eHh4eCIsCiAgIm1lc3NhZ2UiOiAicGF5bWVudCBmb3Igb3JkZXIgcGxhY2VkIE9EMTIzNCIsCiAgInN1Yk1lcmNoYW50SWQiOiAiRGVtb01lcmNoYW50IiwKICAiZW1haWwiOiAiYW1pdCoqKjc1QGdtYWlsLmNvbSIsCiAgInNob3J0TmFtZSI6ICJBbWl0IiwKICAiZ3N0QnJlYWt1cCI6IHsKICAgICJnc3QiOiAxMDAsCiAgICAiY2dzdCI6IDI1LAogICAgImNlc3MiOiAyNSwKICAgICJzZ3N0IjogMjUsCiAgICAiaWdzdCI6IDI1LAogICAgImdzdEluY2VudGl2ZSI6IDEwMCwKICAgICJnc3RQZXJjZW50YWdlIjogMTAKICB9LAogICJpbnZvaWNlRGV0YWlscyI6IHsKICAgICJpbnZvaWNlTnVtYmVyIjogIjEyMzQ1NmZmZmZmIyNfIyMiLAogICAgImludm9pY2VEYXRlIjogIjIwMjEtMDYtMjlUMTA6MTM6NTQuMDIyWiIsCiAgICAiaW52b2ljZU5hbWUiOiAiYmNjYmRfY2pkY2RqYyoqKioqKiIKICB9Cn0="
}
Parameter Name | Type | Description | Mandatory |
---|---|---|---|
|
| Unique |
|
|
| Unique |
|
|
| Unique
|
|
|
| Unique |
|
|
| Transaction amount in Paise |
|
|
|
|
|
|
| .Tag to categorize merchant transaction. |
|
|
| Mobile number of the user |
|
|
| Short message. This message is displayed to the user on completion of payment. |
|
|
| Email address of the user |
|
|
| User's name pre-filled for registration purpose. |
|
|
| Refer below for gstBreakup details |
|
|
| Refer below for invoice details |
|
Parameter Name | Type | Mandatory | Comments |
---|---|---|---|
|
|
| In Paise.Cannot be Negative. |
|
|
| In Paise.Cannot be Negative. |
|
|
| In Paise.Cannot be Negative. |
|
|
| In Paise.Cannot be Negative. |
|
|
| In Paise.Cannot be Negative. |
|
|
| In Paise.Cannot be Negative. |
|
|
| Cannot be Negative. |
Parameter Name | Type | Mandatory | Comments |
---|---|---|---|
|
|
| |
|
|
| Should be of the format 1970-01-01T05:30:00+05:30 |
|
|
|
{
"code": "SUCCESS",
"message": "Your request has been successfully completed.",
"data": {
"redirectType": "WEB",
"redirectURL": "https://mercury-t2.phonepe.com/transaction?token=fkjsdfka9248jfksjdfkilfjksdk"
}
}
Parameter Name | Type | Description |
---|---|---|
|
| Success status of the request |
|
| See list of response codes below |
|
| Short message about code |
Code | Description |
---|---|
| Duplicate |
| The userAuthToken provided is either invalid or not mapped to merchant. |
| Invalid request payload |
| Incorrect X-VERIFY header |
| Something went wrong |
1.Make sure that 'follow redirection' is disabled while calling this API.
2.This location endpoint should be appended to host to get the complete redirection URL.
3.It's recommended to have the server to server call back using x-callback-url header.
Once the transaction is complete, user will be redirected back to the merchant.