Create Reversal

Creates a reversal (refund) of a received PIX payment.

Scope: pix:reversals:write

This endpoint expects an object.

amountstringRequired

Amount in BRL to refund (e.g. “10.00” = R$10.00)

external_idstringRequired

Unique reversal ID in your system

end_to_end_idstringRequired

EndToEndID of the original received PIX payment

reasonstringOptional

Reason for the reversal (optional)

refund_codestringOptional

Code identifying the refund motive

customer_messagestringOptional

user_metadataobjectOptional

tagslist of stringsOptional

Tags for categorization (optional)

Reversal created successfully

idstring

external_idstring

original_end_to_end_idstring

refund_end_to_end_idstring

amountstring

currencystring

statusstring

refund_codestring

created_atstring

400

Bad Request Error

409

Conflict Error

$	curl -X POST https://api.brzip.com.br/api/v1/pix/reversals \
>	-H "X-Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"amount": "10.00",
>	"external_id": "rev-unique-id-001",
>	"end_to_end_id": "E35547753202201201450u34sDGd19l2"
>	}'

1	{
2	"id": "rev_123",
3	"external_id": "a39778df-1c0b-4e37-8d35-dcfa623b66f2",
4	"original_end_to_end_id": "E35547753202201201450u34sDGd19l2",
5	"refund_end_to_end_id": "E24722685202604100755GNZ5DGMBWZK",
6	"amount": "2.5",
7	"currency": "BRL",
8	"status": "completed",
9	"refund_code": "MD06",
10	"created_at": "2026-04-21T23:05:43Z"
11	}

$	curl -X POST https://api.brzip.com.br/api/v1/pix/reversals \
>	-H "X-Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"amount": "10.00",
>	"external_id": "rev-unique-id-001",
>	"end_to_end_id": "E35547753202201201450u34sDGd19l2"
>	}'

1	{
2	"id": "rev_123",
3	"external_id": "a39778df-1c0b-4e37-8d35-dcfa623b66f2",
4	"original_end_to_end_id": "E35547753202201201450u34sDGd19l2",
5	"refund_end_to_end_id": "E24722685202604100755GNZ5DGMBWZK",
6	"amount": "2.5",
7	"currency": "BRL",
8	"status": "completed",
9	"refund_code": "MD06",
10	"created_at": "2026-04-21T23:05:43Z"
11	}