Refunds API

A seamless integration to Super Instant Refunds.

📘

Getting Started

Take a look at the Overview before you start. Here you'll get familiar with the API call sequence, authentication, and how you refund a customer using Super Payments via a webhook you'll need to provide.

Any queries about the best way to implement Super to your store's checkout? Contact us at any time: [email protected].

1. Integrate with the Payments API

Make sure you've completed your integration with the Payments API first.

2. Add your e-commerce storefront details

2.1 Develop your refunds callback url

You need to develop a webhook for Refunds before you can complete your setup. This webhook is called by the Super Payments gateway to inform you of refund status.

2.2 Set your refund callback url

Once you've got your Super Payments refunds url live, add your refunds callback url to your business portal.

697

3. Initiate a refund

You should initiate a refund request passing in your transactionID

❗️

Code snippet

Please treat the following code snippets as illustrative examples rather than working code.

curl --request POST \
     --url https://api.superpayments.com/v2/refunds \
     --header 'accept: application/json' \
     --header 'checkout-api-key: your key' \
     --header 'content-type: application/json' \
     --data '
{
     "currency": "GBP",
     "transactionId": "27b2ae04-cb8e-4bcb-a976-d14a40518db1",
     "minorUnitAmount": 10000,
     "externalReference": "refund101",
     "test": true
}
'