Pagos
Un objeto Payment representa el intento de cobrar a un cliente. Es el recurso central de la API y soporta tarjeta presente (TPV) y no presente (e-commerce, ligas, recurrentes).
El objeto Payment
{
"id": "pay_3K9aB2X7QvLm",
"object": "payment",
"amount": 25000,
"currency": "MXN",
"status": "approved",
"captured": true,
"authorization_code": "742193",
"source": {
"id": "src_4242",
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2029
},
"customer": "cus_8B2nM1Q9TfYr",
"description": "Pedido #1042",
"metadata": { "order_id": "1042" },
"created_at": "2026-06-04T17:42:11Z",
"livemode": false
}Endpoints
/v1/payments
/v1/payments/:id
/v1/payments
/v1/payments/:id/capture
/v1/payments/:id/refund
Crear un pago
curl https://api.ipagos.lat/v1/payments \
-u sk_sandbox_xxxxxxxxxxxxxxxxxxxxx: \
-H "Idempotency-Key: $(uuidgen)" \
-d amount=25000 \
-d currency=MXN \
-d source=tok_visa_4242 \
-d description="Pedido #1042" \
-d "metadata[order_id]=1042"Estados posibles
pending — esperando autorización 3DS o respuesta del banco.approved — autorizado y capturado.authorized — autorizado pero no capturado (capture manual pendiente).declined — el banco emisor rechazó el cargo.refunded — reembolsado total.partially_refunded — reembolsado parcial.disputed — el tarjetahabiente abrió un contracargo.