curl --request POST \
--url https://api.malga.io/v1/purchases/{id}/void \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--data '{}'{
"id": "550e8400-e29b-41d4-a716-446655440000",
"merchantId": "3b8c1f2a-4d5e-6f70-8192-a3b4c5d6e7f8",
"amount": 15000,
"currency": "BRL",
"capture": false,
"status": "pending",
"updatedAt": "2026-07-27T18:06:00Z",
"payments": [
{
"slotIndex": 0,
"amount": 10000,
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"status": "pre_authorized",
"refundedAmount": 0,
"chargeId": "11111111-2222-3333-4444-555555555555",
"paymentSource": {
"sourceType": "card",
"cardId": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
},
"card": {
"brand": "Visa",
"last4": "4242"
}
},
{
"slotIndex": 1,
"amount": 5000,
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"status": "pre_authorized",
"refundedAmount": 0,
"chargeId": "66666666-7777-8888-9999-000000000000",
"paymentSource": {
"sourceType": "token",
"tokenId": "9f8e7d6c-5b4a-3928-1706-5e4d3c2b1a09"
},
"card": {
"brand": "Mastercard",
"last4": "4444"
}
}
],
"createdAt": "2026-07-27T18:00:00Z",
"operation": {
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"type": "void",
"status": "pending"
}
}Cancelar ou estornar uma Venda
Rota única para desfazer uma Venda, com o campo opcional intent:
cancel: cancela as pré-autorizações de uma Vendapendingcom todos os cartõespre_authorized. Responde202comoperation.type: voide a Venda terminacancelled.refund: estorna o valor integral de uma Vendapaid. Responde202comoperation.type: refunde a Venda permanecepaid.
Sem intent (corpo vazio, {} ou intent: ""), a Malga decide pelo estado da Venda: paid estorna e os demais estados cancelam, com as mesmas regras acima. Envie intent explicitamente para garantir que um cancelamento nunca vire estorno caso a Venda seja capturada entre a sua leitura e a chamada.
Campos extras no corpo (como amount) devolvem 400. Sem X-Idempotency-Key, ou com intent fora do enum, a API devolve 422 com invalid_request. Reenviar a mesma chave com o mesmo corpo devolve 202 com o estado atual da Venda.
Casos de 409:
idempotency_key_payload_mismatch: a chave já foi usada com outro corpo ou em outra operação.purchase_operation_in_progress: já existe uma operação em andamento e você enviou uma chave nova.purchase_intent_mismatch:cancelem Vendapaid, ourefundem Venda com cartões apenas pré-autorizados. Nenhum valor é movimentado.purchase_invalid_state: estado misto, Vendafailedoucancelled, ou sem saldo estornável.
curl --request POST \
--url https://api.malga.io/v1/purchases/{id}/void \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--data '{}'{
"id": "550e8400-e29b-41d4-a716-446655440000",
"merchantId": "3b8c1f2a-4d5e-6f70-8192-a3b4c5d6e7f8",
"amount": 15000,
"currency": "BRL",
"capture": false,
"status": "pending",
"updatedAt": "2026-07-27T18:06:00Z",
"payments": [
{
"slotIndex": 0,
"amount": 10000,
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"status": "pre_authorized",
"refundedAmount": 0,
"chargeId": "11111111-2222-3333-4444-555555555555",
"paymentSource": {
"sourceType": "card",
"cardId": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
},
"card": {
"brand": "Visa",
"last4": "4242"
}
},
{
"slotIndex": 1,
"amount": 5000,
"paymentMethod": {
"paymentType": "credit",
"installments": 1
},
"status": "pre_authorized",
"refundedAmount": 0,
"chargeId": "66666666-7777-8888-9999-000000000000",
"paymentSource": {
"sourceType": "token",
"tokenId": "9f8e7d6c-5b4a-3928-1706-5e4d3c2b1a09"
},
"card": {
"brand": "Mastercard",
"last4": "4444"
}
}
],
"createdAt": "2026-07-27T18:00:00Z",
"operation": {
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"type": "void",
"status": "pending"
}
}Headers
Body
Corpo opcional do cancelamento ou do estorno
Response
Cancelamento ou estorno aceito. Numa repetição idempotente, a operação pode já estar processing
Venda paga com 2 ou 3 cartões
Was this page helpful?