Refunds | SumUp Developer

Overview

In this guide, you will learn how to refund a transaction. You will go through the following steps:

Look up a transaction ID (Optional)
Refund a transaction by using one of the available options:
- Option A: Make a full refund
- Option B: Make a partial refund

When you complete these steps, the payment you have previously processed through SumUp will be refunded either partially or in full.

Before You Begin

Here are the things that you need in order to complete the steps in this guide:

SumUp merchant account(Opens in a new tab) with completed account details(Opens in a new tab).
- You can also use a sandbox merchant account.
Registered client application with SumUp.
Valid access token obtained with the Authorization code flow.
You have processed a checkout and you have the checkout ID.

Note

Transactions are associated with active merchant user accounts. As a result, you cannot use an access token obtained via the Client credentials flow to complete the steps in this guide.

Steps

1. Look up a Transaction ID

Note

If you already have the ID of the transaction you want to refund, you can skip this step and continue with Step 2.

Make a GET request to the https://api.sumup.com/v0.1/checkouts/{id} endpoint, where the value of the {id} path parameter is the identifier of the checkout resource.

Example request:

1curl -X GET \
2https://api.sumup.com/v0.1/checkouts/4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2 \
3-H "Authorization: Bearer $SUMUP_API_KEY"

1const checkout = await client.checkouts.get("4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2");

1var checkout = await client.Checkouts.GetAsync("4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2");

1var checkout = client.checkouts().getCheckout("4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2");

1ctx := context.Background()
2client := sumup.NewClient()
3
4checkout, err := client.Checkouts.Get(ctx, "4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2")

1checkout = client.checkouts.get("4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2")

1let checkout = client
2.checkouts()
3.get("4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2")
4.await?;

1<?php
2
3$checkout = $sumup->checkouts->get('4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2');
4$checkoutReference = $checkout->checkout_reference;
5$checkoutId = $checkout->id;

The response contains a JSON body with the full details of the processed checkout resource. You can find the transaction ID in the id attribute of the respective transaction resource (664200af-2b62-4142-9c73-a2a505310d78 in the sample response below).

1{
2  "checkout_reference": "CO287866",
3  ...
4  "id": "4ebc2ed7-bb8c-4d4d-a110-08fd31301bf2",
5  ...
6  "transactions": [
7    {
8      "id": "664200af-2b62-4142-9c73-a2a505310d78",
9      ...
10    }
11  ]
12}

Make a Full Refund

Make a POST request with an empty request body to the https://api.sumup.com/v0.1/me/refund/{txn_id} endpoint, where the value of the {txn_id} path parameter is the identifier of the transaction resource.

Example request for the transaction with identifier 664200af-2b62-4142-9c73-a2a505310d78:

1curl -X POST \
2https://api.sumup.com/v0.1/me/refund/19aa3cca-89f6-42d2-b462-463b0b53e959 \
3-H "Authorization: Bearer $SUMUP_API_KEY"

1await client.transactions.refund("19aa3cca-89f6-42d2-b462-463b0b53e959");

1await client.Transactions.RefundAsync("19aa3cca-89f6-42d2-b462-463b0b53e959");

1client.transactions().refundTransaction(
2  "19aa3cca-89f6-42d2-b462-463b0b53e959",
3  RefundTransactionRequest.builder().build()
4);

1ctx := context.Background()
2client := sumup.NewClient()
3
4err := client.Transactions.Refund(ctx, "19aa3cca-89f6-42d2-b462-463b0b53e959", sumup.TransactionsRefundParams{})

1from sumup.transactions.resource import RefundTransactionBody
2
3client.transactions.refund(
4"19aa3cca-89f6-42d2-b462-463b0b53e959",
5RefundTransactionBody(),
6)

1client
2.transactions()
3.refund("19aa3cca-89f6-42d2-b462-463b0b53e959", None)
4.await?;

1<?php
2
3$sumup->transactions->refund('19aa3cca-89f6-42d2-b462-463b0b53e959');

The response returns a 204 HTTP status code and contains no body.

Make a Partial Refund

Make a POST request to the https://api.sumup.com/v0.1/me/refund/{txn_id} endpoint, where the value of the {txn_id} path parameter is the identifier of the transaction resource.

Unlike the option for a full refund, the request body for partial refunds should be a JSON object with the amount you want to refund for the transaction.

Example request for a partial refund for the amount of 24.42 EUR:

1curl -X POST \
2https://api.sumup.com/v0.1/me/refund/19aa3cca-89f6-42d2-b462-463b0b53e959 \
3-H "Authorization: Bearer $SUMUP_API_KEY" \
4-H 'Content-Type: application/json' \
5-d '{"amount": 24.42}'

1await client.transactions.refund("19aa3cca-89f6-42d2-b462-463b0b53e959", {
2amount: 24.42,
3});

1await client.Transactions.RefundAsync(
2  "19aa3cca-89f6-42d2-b462-463b0b53e959",
3  new TransactionsRefundRequest
4  {
5      Amount = 24.42f,
6  });

1client.transactions().refundTransaction(
2  "19aa3cca-89f6-42d2-b462-463b0b53e959",
3  RefundTransactionRequest.builder().amount(24.42f).build()
4);

1ctx := context.Background()
2client := sumup.NewClient()
3
4amount := float32(24.42)
5client.Transactions.Refund(ctx, "19aa3cca-89f6-42d2-b462-463b0b53e959", sumup.TransactionsRefundParams{
6Amount: &amount,
7})

1from sumup.transactions.resource import RefundTransactionBody
2
3client.transactions.refund(
4"19aa3cca-89f6-42d2-b462-463b0b53e959",
5RefundTransactionBody(amount=24.42),
6)

1use sumup::resources::transactions::RefundTransactionBody;
2
3client
4.transactions()
5.refund(
6"19aa3cca-89f6-42d2-b462-463b0b53e959",
7Some(RefundTransactionBody { amount: Some(24.42) }),
8)
9.await?;

1<?php
2
3$sumup->transactions->refund('19aa3cca-89f6-42d2-b462-463b0b53e959', [
4'amount' => 24.42,
5]);

The response returns a 204 HTTP status code and contains no body.

Result

You have successfully refunded a transaction (either partially or in full) for a payment you previously processed. The refunded amount will be credited to the same payment method the customer had used to pay with in the original transaction. The processing fees associated with the original transaction are not returned.