Reembolsos
Atualizar um reembolso
Atualiza a metadata de um refund.
curl -X POST "https://api.chargefy.io/v1/refunds/re_cDC7XfngnGLJnxPe" \
-H "Authorization: Bearer {{API_KEY}}" \
-H "Content-Type: application/json" \
-d '{
"metadata": {}
}'
{
"id": "re_cDC7XfngnGLJnxPe",
"object": "refund",
"amount": 5000,
"balance_transaction": "txn_dJ78rx244VMSCuQi",
"charge": "ch_bF28SsVU6KaAwb6K",
"created_at": "2026-05-20T18:35:00Z",
"currency": "brl",
"customer": "cus_5fGvGKkCkUJqheLL",
"description": "Reembolso parcial do pedido original",
"destination_details": {
"card_last4": "4242",
"type": "credit_card"
},
"failure_balance_transaction": null,
"failure_reason": null,
"instructions_email": "nome@email.com",
"livemode": true,
"metadata": {},
"next_action": null,
"payment_intent": "pi_oUSxPi9vAwwdm76B",
"pending_reason": null,
"reason": "requested_by_customer",
"receipt_number": "RR-2026-0001",
"source_transfer_reversal": null,
"status": "succeeded",
"transfer_reversal": null,
"updated_at": "2026-05-20T18:40:00Z"
}
Atualiza apenas a
metadata de um refund. Os demais campos são controlados
pelo fluxo financeiro do refund.
string
required
ID do refund (
re_*).object
required
Pares chave-valor livres associados ao refund. O objeto enviado substitui a
metadata anterior.
curl -X POST "https://api.chargefy.io/v1/refunds/re_cDC7XfngnGLJnxPe" \
-H "Authorization: Bearer {{API_KEY}}" \
-H "Content-Type: application/json" \
-d '{
"metadata": {}
}'
{
"id": "re_cDC7XfngnGLJnxPe",
"object": "refund",
"amount": 5000,
"balance_transaction": "txn_dJ78rx244VMSCuQi",
"charge": "ch_bF28SsVU6KaAwb6K",
"created_at": "2026-05-20T18:35:00Z",
"currency": "brl",
"customer": "cus_5fGvGKkCkUJqheLL",
"description": "Reembolso parcial do pedido original",
"destination_details": {
"card_last4": "4242",
"type": "credit_card"
},
"failure_balance_transaction": null,
"failure_reason": null,
"instructions_email": "nome@email.com",
"livemode": true,
"metadata": {},
"next_action": null,
"payment_intent": "pi_oUSxPi9vAwwdm76B",
"pending_reason": null,
"reason": "requested_by_customer",
"receipt_number": "RR-2026-0001",
"source_transfer_reversal": null,
"status": "succeeded",
"transfer_reversal": null,
"updated_at": "2026-05-20T18:40:00Z"
}
⌘I
curl -X POST "https://api.chargefy.io/v1/refunds/re_cDC7XfngnGLJnxPe" \
-H "Authorization: Bearer {{API_KEY}}" \
-H "Content-Type: application/json" \
-d '{
"metadata": {}
}'
{
"id": "re_cDC7XfngnGLJnxPe",
"object": "refund",
"amount": 5000,
"balance_transaction": "txn_dJ78rx244VMSCuQi",
"charge": "ch_bF28SsVU6KaAwb6K",
"created_at": "2026-05-20T18:35:00Z",
"currency": "brl",
"customer": "cus_5fGvGKkCkUJqheLL",
"description": "Reembolso parcial do pedido original",
"destination_details": {
"card_last4": "4242",
"type": "credit_card"
},
"failure_balance_transaction": null,
"failure_reason": null,
"instructions_email": "nome@email.com",
"livemode": true,
"metadata": {},
"next_action": null,
"payment_intent": "pi_oUSxPi9vAwwdm76B",
"pending_reason": null,
"reason": "requested_by_customer",
"receipt_number": "RR-2026-0001",
"source_transfer_reversal": null,
"status": "succeeded",
"transfer_reversal": null,
"updated_at": "2026-05-20T18:40:00Z"
}

