Requests

Instant Refunds with Buckaroo

Instant refunds allow you to send a refund request via API that will be processed as an instant payment. This method ensures that consumers get their money back immediately and securely.

Supported Payment Methods

iDEAL
Sofort
Payconiq

Example Refund Request

{
  "Currency": "EUR",
  "AmountCredit": 0.01,
  "Description": "&Automated test iDEAL with ING issuer in request",
  "Invoice": "Automatedtest_iDEAL_0005",
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
  "ReturnURLError": "https://www.buckaroo.nl/mislukt",
  "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
  "OriginalTransactionKey": "19185ACB6E2E42C99F3E0E6A********",
  "ClientIP": {
      "Type": 0,
      "Address": "0.0.0.0"
   },
  "Services": {
    "ServiceList": [
      {
        "Name": "iDEAL",
        "Action": "InstantRefund",
        "Parameters": []
      }
    ]
  }
}

Example Response

{
  "Key": "62F3916AE4F4412C9BD461**********",
  "Status": {
    "Code": {
      "Code": 190,
      "Description": "Success"
    },
    "SubCode": {
      "Code": "S001",
      "Description": "Transaction successfully processed"
    },
    "DateTime": "2023-04-18T13:45:22"
  },
  "RequiredAction": null,
  "Services": [
    {
      "Name": "ideal",
      "Action": null,
      "Parameters": [
        {
          "Name": "customeraccountname",
          "Value": "Mr Tester"
        },
        {
          "Name": "CustomerIBAN",
          "Value": "NL37INGB0*********"
        },
        {
          "Name": "CustomerBIC",
          "Value": "INGBNL2A"
        },
        {
          "Name": "Processed",
          "Value": "Instant"
        }
      ]
    }
  ],
  "CustomParameters": null,
  "AdditionalParameters": null,
  "RequestErrors": null,
  "Invoice": "Automatedtest_iDEAL_0005",
  "ServiceCode": "ideal",
  "IsTest": false,
  "Currency": "EUR",
  "AmountCredit": 0.01,
  "TransactionType": "C121",
  "MutationType": 1,
  "RelatedTransactions": [
    {
      "RelationType": "refund",
      "RelatedTransactionKey": "19185ACB6E2E42C99F3E0E6A********"
    }
  ],
  "ConsumerMessage": null,
  "Order": null,
  "IssuingCountry": null,
  "StartRecurrent": false,
  "Recurring": false,
  "CustomerName": null,
  "PayerHash": null,
  "PaymentKey": "1622F04874DC4E76AE1BC9***********"
}

Example Push Response

{
    "Transaction": {
        "Key": "62F3916AE4F4412C9BD461",
        "Invoice": "Automatedtest_iDEAL_0005",
        "ServiceCode": "ideal",
        "Status": {
            "Code": {
                "Code": 190,
                "Description": "Success"
            },
            "SubCode": {
                "Code": "S001",
                "Description": "Transaction successfully processed"
            },
            "DateTime": "2023-04-18T13:45:22"
        },
        "IsTest": false,
        "Order": null,
        "Currency": "EUR",
        "AmountCredit": 0.01,
        "TransactionType": "C121",
        "Services": [
            {
                "Name": "ideal",
                "Action": null,
                "Parameters": [
                    {
                        "Name": "customeraccountname",
                        "Value": "Mr Tester"
                    },
                    {
                        "Name": "CustomerIBAN",
                        "Value": "NL37INGB0*********"
                    },
                    {
                        "Name": "CustomerBIC",
                        "Value": "INGBNL2A"
                    },
                    {
                        "Name": "Processed",
                        "Value": "Instant"
                    }
                ],
                "VersionAsProperty": 2
            }
        ],
        "CustomParameters": null,
        "AdditionalParameters": null,
        "MutationType": 1,
        "RelatedTransactions": [
            {
                "RelationType": "refund",
                "RelatedTransactionKey": "19185ACB6E2E42C99F3E0E6A********"
            }
        ],
        "IsCancelable": false,
        "IssuingCountry": null,
        "StartRecurrent": false,
        "Recurring": false,
        "CustomerName": null,
        "PayerHash": null,
        "PaymentKey": "1622F04874DC4E76AE1BC9***********",
        "Description": "&Automated test iDEAL with ING issuer in request"
    }
}