Endpoints

GET /api/v1/payments/{id}

Recupera una transacción por ID.

GET/api/v1/payments/{id}secret key

Recupera una transacción por ID. Útil para confirmar el estado tras redirección del checkout. El campo `paymentMethodId` en la respuesta es el mismo id 4-dígitos que enviaste al crearla — round-trip completo. El path legacy `GET /api/v1/transactions/{id}` sigue funcionando idéntico.

Request

curl https://sandbox.key2pays.com/api/v1/payments/TXN-MVZQXW7B-A4F2 \
  -H "Authorization: Bearer sk_test_51N8mP...exampleK3Y"

Response

{
  "id": "TXN-MVZQXW7B-A4F2",
  "status": "completed",
  "amount": 50.00,
  "currency": "USD",
  "amountLocal": 882.17,
  "currencyLocal": "MXN",
  "paymentMethodId": "1001",
  "paymentMethod": "spei",
  "fees": { "platform": 1.45, "provider": 1.50, "network": 1.50, "total": 4.45 },
  "settlement": { "type": "delayed", "delay": "48h", "status": "pending" },
  "timestamps": { "created": "2026-05-12T15:50:00Z" }
}

Previous · Endpoints

POST /api/v1/payments

Next · Endpoints

GET /api/v1/payments