Manual Integration

A simple guide to manually integrate with Super Payments API.

Here's how to start taking payment and issuing refunds for your customers.

Payments

Integrating with the Payments API is simple.

  • Generate a reward calculation based on your payment amount
  • Initiate a payment, and redirect your customer to pay with Super Payments.
  • Handle the payment response via a webhook to create an order, or return your customer back to checkout.

You'll find details for Super Payments authentication here.

Simply follow the Payments API instructions to directly integrate with the Super Payments public API.

878

Here's a shell command example of the reward-calculations/ and payments/ requests you can try out yourself...

❗️

Code snippets

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

curl --request POST \
     --url https://api.superpayments.com/2024-02-01/reward-calculations \
     --header 'Authorization: <<apiKey>>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
       "amount":91234, 
       "brandId": "<<brandId>>", 
       "currency":"GBP"
     }'
'
'

The response from the reward-calculations request will provide you with the rewardCalculationId that you must pass in the request to the payments api.

curl --request POST \
     --url https://api.superpayments.com/2024-02-01/payments \
     --header 'Authorization: <<apiKey>>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json'
     --data '{
       "brandId":"<<brandId>>", 
       "amount":91234, 
       "rewardCalculationId":"<<rewardCalculationId>>", 
       "currency":"GBP",      
       "successUrl": "https://www.yourwebsite.com/success.html",
       "cancelUrl": "https://www.yourwebsite.com/cancel.html",
       "failureUrl": "https://www.yourwebsite.com/fail.html"
     }'

Refunds

Processing an instant full or partial refunds with Refunds API is simple.

  • Initiate a refund
  • Handle the refund response via a webhook to process the refund. You must provide this webhook to receive these updates from Super Payments.

You'll find details for Super Payments authentication here.

Simply follow the Refunds API instructions to directly integration with Super Payments public API.

601

Here's a shell command example of the refunds/ requests you can try out yourself...

curl --request POST \
     --url https://api.superpayments.com/2024-02-01/refunds \
     --header 'Authorization: <<apiKey>>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "transactionId": "<<paymentTransactionId>>",
  "amount": 10000,
  "currency": "GBP",
  "externalReference": "refund101",
  "brandId": "<<brandId>>"
}
'

Rewards Configuration

Use the Get Reward Configuration Endpoint to retrieve the current rewards configuration for a specific brand.


curl --request GET \
     --url https://api.superpayments.com/2024-02-01/brands/<<brandId>>/reward-configuration \
     --header 'Authorization: <<apiKey>>' \
     --header 'accept: application/json'

Update the existing configuration with the Upsert Brand Reward Configuration Endpoint


curl --request PUT \
     --url https://api.superpayments.com/2024-02-01/brands/<<brandId>>/reward-configuration \
     --header 'Authorization: <<apiKey>>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "rewardPercentage": 1,
  "minimumSpend": {
    "currency": "GBP",
    "amount": 1000
  },
  "rewardsExpireAfter": 864000
}
'