Refund — Payout Developers

Generate api key and secret
- You can do it in backoffice (Sandbox or Production) after you have already created account.
- It's required to add notify url before api key is generated. This url will be used for sending webhook notifications (POST HTTP Requests) about state of checkouts and other events.

Make authorization call to get Bearer token

Command Line

curl --location --request POST 'https://sandbox.payout.one/api/v1/authorize' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
 "client_id": "DC995618-7ED8-4070-9DA0-48B6F86551C3",
 "client_secret": "q3dpHpYtDrH-KmGD4HMn5OTEx6IsZPBokQ8CqMONWqMSEePWy9bXd3Ua3KvO7f6C"
}'

Response of this call looks like this:

JSON

{
 "token": "SFMyNTY.g2gDYSFuBgCaSXELfgFiAAFRgWnBcvEfet1jIr9OPF984RGTKu-8HcHPQKJitk_kJKiU",
 "valid_for": 6000
}

Create request with details from checkout. It's POST HTTP call with JSON body. Call have to contain also Authorization header with Bearer token from previous step

Command Line

curl --location --request POST 'https://sandbox.payout.one/api/v1/refunds' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SFMyNTY.g2gDYSFuBgCaSXELfgFiAAFRgA.WnBcvEfet2jJr4OPF984RGTKu-8HcHPQKJitk_kJKiU' \
--header 'Accept: application/json' \
--header 'Idempotency-Key: 74775d02-745f-4198-cf3c-be9f1971dabe' \
--data-raw '{
      "amount": 100,
      "checkout_id": 141209, 
      "iban": "SK5511000000002611391222",
      "statement_descriptor": "Description on customer statement",
      "nonce": "1474e979-9f64-012a-6d8a-f00957d4a4a0",
      "signature": "ef30790284ffb097e7e4b0d1162db605f97f52c59f0cfc877870bde4e61f7d77" 
}'

Note

Amount is in cents (EUR), so 3 EUR is 300. It's same for other currencies, for example 300 CZK is 30000. This parameter is optional.

Signature is generated from string with this pattern:

Code

amount|currency|external_id|iban|nonce|client_secret

This string is hashed with SHA256 and encoded with Base16 to this form:

Code

ef30790284ffb097e7e4b0d1162db605f97f52c59f0cfc877870bde4e61f7d77

Note

Some algorithms implementations generate output in UPPERCASE form so please change all characters into lowercase form.