Skip to main content
POST
/
charges
/
{charge_id}
/
resolve
curl https://api.onepay.la/v1/charges/9e02966f-2ddf-4ee7-a391-5b5b7653e232/resolve \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "approve"
  }'

{
  "id": "9e02966f-2ddf-4ee7-a391-5b5b7653e232",
  "status": "paid",
  "remarks": null,
  "paid_at": "2026-02-20T17:14:00.000000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.onepay.la/llms.txt

Use this file to discover all available pages before exploring further.

Este endpoint solo funciona con cargos de prueba (is_test: true). Si intentas resolver un cargo de producción, recibirás un error 403.
Permite simular la respuesta de un gateway de pago para cargos que quedaron en estado processing o created en ambiente de pruebas.

​
¿Cuándo usarlo?

Cuando creas un cargo en sandbox y el resultado es processing (por ejemplo, con cuentas bancarias que no tienen un patrón de auto-aprobación), puedes usar este endpoint para completar el flujo manualmente — simulando que el gateway responde aprobando o rechazando la transacción.
​
charge_id
string
required
ID del cargo o source_id del cargo a resolver. Debe estar en estado processing o created.
​
action
string
required
Acción a ejecutar sobre el cargo. Valores válidos:
  • approve - Aprueba el cargo (transición a paid)
  • reject - Rechaza el cargo (transición a failed)
​
remarks
string
Motivo del rechazo. Requerido cuando action es reject.Acepta cualquier código de los escenarios de prueba, por ejemplo:
  • INSUFFICIENT_FUNDS - Fondos insuficientes
  • RISK_CONTROL - Bloqueado por control de riesgo
  • CARD_EXPIRED - Tarjeta expirada
  • TRANSACTION_REJECTED - Rechazado por el banco
Consulta la lista completa en escenarios de prueba.

​
Aprobar un cargo

curl https://api.onepay.la/v1/charges/9e02966f-2ddf-4ee7-a391-5b5b7653e232/resolve \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "approve"
  }'

​
Rechazar un cargo con motivo

curl https://api.onepay.la/v1/charges/9e02966f-2ddf-4ee7-a391-5b5b7653e232/resolve \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "reject",
    "remarks": "RISK_CONTROL"
  }'

{
  "id": "9e02966f-2ddf-4ee7-a391-5b5b7653e232",
  "status": "paid",
  "remarks": null,
  "paid_at": "2026-02-20T17:14:00.000000Z"
}