feature

Refund

Learn how to refund a customer's order.

1

authorise

Authorise a transaction once a spend option has been chosen.

post
/merchant/{customerRef}/authorisation
See API reference
2

settle

Settle the authorisation once the order has been received.

3

refund

Refund an authorisation once the order has been settled.

Request Example

Request

1curl --request POST \
2  --url https://mtapi.stg-newdaytechnology.net/cl/merchant-gateway-service//merchant/123456789/authorisation \
3  --header 'client-session-id: SOME_STRING_VALUE' \
4  --header 'content-type: application/json' \
5  --header 'context-merchantId: bf62723f-f664-4527-b95b-4dfee33e427d' \
6  --header 'context-tenantId: SOME_STRING_VALUE' \
7  --header 'customer-access-token: SOME_STRING_VALUE' \
8  --header 'idempotency-key: EE735673-05F2-4C56-8A68-60170BDA4524' \
9  --header 'sca-token: SOME_STRING_VALUE' \
10  --data '{"amount":{"value":50,"currencyCode":"GBP"},"orderReference":"0000123456","description":"A fridge","verificationId":"string","spendOptionId":"efb4929f-e781-4503-9035-18926cae56fd"}'

Response Example

Response

JSON

1{
2  "authorisationId": "6fe486cf-3193-40ef-a850-f7659e717c6e",
3  "result": "Authorised",
4  "declineReason": "Declined (Please speak to your credit issuer)"
5}