Use a refund request to return a payment to a customer, for example, if they returned an item, you need to refund the payment.

You can only refund a payment after it has already been captured. Payments that have not yet been captured (pre-authorized) have to be cancel instead.

There are two types of refunds you might need to process:

  • Full refund. A full refund returns the total amount of the payment to the customer — it can only be performed once.
  • Partial refund. A partial refund returns a sum less than the captured amount. Payment can be refunded multiple times, but cannot exceed the original payment amount.

The Refund request will send a credit note to the authorization system after the customer’s credit card has already been charged. The refund amount will be credited to the customer’s credit card and the merchant’s account will be charged.


Overview

To process a refund successfully, you must provide the transaction ID of the captured payment. You can find the ID:

  • In response to the payment request
  • In the webhook notification
    The requests are the same for partial and full refunds. Any refunds for less than the original captured amount will be considered partial refunds.

Step 1. Make a refund request

Make a POST request from your server to payabl.

POST https://sandbox.payabl.com/pay/backoffice/payment_refund

Request example

POST data: merchantid=api_test&amount=1.23&currency=EUR&signature=d7e5ab7372bcaea98921e270a0b751
dcae627ea2&transactionid=6905370

Step 2. Receive response

A successful refund request returns a successful response. However, if there was a problem with your request, you'll receive an error response.

Response example

transactionid=105898756&transid=105898756&status=0&errormessage=&errmsg=&amount=1.23&price=1.23&currency=EUR&orderid=api-test-123

Our Technical Support team is there to help you:
Email: [email protected]
Available Monday – Friday between 09:00 and 17:00 CET/CEST