Cobrar y emitir un cupón

POST

https://api.dev-firmaseguraec.com/checkout/pos/purchase

Última modificación:2026-10-06 21:07:13

Registra la venta y emite un cupón de un solo uso para la vigencia indicada. El titular recibe en cellphone un SMS con el enlace para canjearlo, y el mismo enlace vuelve en url por si el terminal quiere mostrarlo o imprimirlo. El cupón vence en expiresAt.

Reintentar sin duplicar. Si la venta lleva externalReference y el aliado ya tiene un cupón con esa referencia, no se emite otro: responde 200 con el existente, sin url y sin reenviar el SMS. Sin externalReference, cada llamada emite un cupón nuevo.

Permiso: write:signature:pos_purchase. Para que el canje pueda originar la firma, el aliado necesita además write:signature:request y read:signature:session_tracking: la firma se origina con su token.

Solicitud

Autorización

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Venta ya registrada

application/json

Ya había un cupón con esa externalReference: se devuelve ese, sin url y sin reenviar el SMS.

Bodyapplication/json

🟢201Cupón emitido

🟠400Validación de Campos

🟠401Token inválido

🟠403Venta no autorizada

🟠409Conflicto

🟠429Límite de cupones por hora

⚪x-403:Sin permisoSin permiso

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Con referencia de la ventaSin referencia de la venta

curl --location 'https://api.dev-firmaseguraec.com/checkout/pos/purchase' \
--header 'Content-Type: application/json' \
--data '{
    "period": "ONE_YEAR",
    "cellphone": "0991234567",
    "externalReference": "FAC-001-002-000123456"
}'

Ejemplo de Respuesta

200 - Éxito

{
    "voucherUid": "b46ee02e-9a68-4eef-b075-6b3706acebf5",
    "expiresAt": "2026-10-07T15:57:51.425868-05:00"
}

Modificado en 2026-10-06 21:07:13

Vigencias que el aliado puede vender

VoucherResponse