Refund
The Refund request will follow a successful Capture request. The Refund request will send a credit note to the authorization system after the customer’s account has already been charged. The refund amount will be credited to the customer’s account and the merchant’s account will be charged.
POST URL: https://sandbox.payabl.com/pay/backoffice/payment_refund
REQUEST PARAMETERS
The POST request should contain the following components:
- Refund Data
RESPONSE & SAMPLE CODES
- Refund Response
- Test Credentials
EXAMPLE:
- Refund Request & Response
REFUND DATA
The Refund interface requires the following fields:
| Field Name | Type | Length | Format | Mandatory? | Description |
|---|---|---|---|---|---|
| merchantid | alphanumeric | 40 characters | ✔ | merchant identification | |
| transactionid | numeric | max. 50 digits | ✔ | identification of transaction | |
| amount | float numeric | 8.2 8 | 12345678.90 12345678 | ✔ | amount should not be higher than original transaction amount |
| currency | char | 3 | ISO 4217 | ✔ | currency |
| signature | hexadecimal | 40 characters | SHA-1 hash value (hexadecimal) | ✔ | Signature Calculation |
| language | char | 2 characters | ISO Code 639 alpha 2 | language in which the error messages will be displayed | |
| external_id | alphanumeric* | 255 characters | Merchant’s unique id |
REFUND RESPONSE
The response contains the following fields:
| Field Name | Type | Content | Description |
|---|---|---|---|
| status | numeric | status, mandatory | 0 = no error, 2000 = pending, any other value is an error code. |
| errormessage | alphanumeric | empty or error message | error messages of the payment gateway or empty |
| Errmsg | alphanumeric | empty or error message | error messages of the payment gateway or empty |
| transactionid | numeric | transactionid, mandatory | payment gateway transaction identification for interfaces preauthorize and authorize |
| transid | numeric | transid | transid (deprecated) |
| price | numeric | empty or price value | price (deprecated) |
| amount | numeric | empty or amount value | amount |
| currency | char | empty or currency value | currency |
| orderid | alphanumeric | empty or orderid value | orderid in the merchant shop system |
Our Technical Support team is there to help you:
Email: [email protected]
Telephone: +49 69 9434 09141
Available Monday – Friday between 09:00 and 17:00 CET/CEST
Updated 4 months ago