Refunds & chargebacks

Refunds

Refunds are only available for some paymentProducts. They are always associated to Payins, you may create multiple Refunds for a single Payin (just like there can be multiples Payins for a single Authorization).

Parameters

You can optionally use the following parameters for creating a refund.

Attribute	Type	Description
currency	string	The currency of the refund, in ISO-4217 format.
amount	number	The amount of the refund. Can be specified to partially refund a payin. If omitted, the payin is entirely refunded.
profile	string	The MID. Required if you have multiple MIDs.

Request

CURL

curl -X POST {baseUrl}/v1/payinrefunds \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \
	-d '{payload}'

Here is an example of {payload}:

JSON

{
    "payinId":"00b9cde9-0aa5-44ba-8e3a-f91fc4c29e39",
    "amount":19.99,             // If not specified, the whole payin is refunded
    "currency":"EUR"
}

Returns the Payin Refund object and sends payinrefund.create and payinrefund.update webhooks.

JSON

{
	"payinRefunds": [
		{
		"payinrefundId": "string",
		"payinrefundTag": "null",
		"payinrefundStatus": "string",
		"walletId": "string",
		"payinId": "string",
		"amount": 19.99,
		"currency": "EUR",
		"createdDate": "string",
		"modifiedDate": "string",
		"payinrefundDate": "string",
		"profile": "string"
		}
	]
}

Chargebacks

When a Chargeback is received, Treezor sends:

• A card.acquiring.chargeback.create webhook.
• As many payinrefund.create and payinrefund.update webhooks as necessary (if multiple captures occurred for a single authorization)

The chargeback is automatically accepted and the Wallet debited (even if insufficiently provisioned). You do not have the ability to refuse it.