Crear un Pago por código de barras
POST/v2/payments/barcode
Crea un pago a partir solo del código de barras o de la línea digitable. El tipo del pago se resuelve por el propio código, siguiendo el layout FEBRABAN v08, y se devuelve en el campo kind de la respuesta:
| Código | kind |
|---|---|
47 posiciones, o 44 que no comienzan con 8 | bank_billet |
comienza con 8, segmento 2, 3, 4, 6 o 7 | utility |
comienza con 8, segmento 1 o 5 | tax, con tax.kind = "unknown" y tax.format = "code" |
El código se rechaza con 422 cuando un dígito verificador no coincide (el general, en el boleto y en la recaudación, y los de campo o de bloque de la línea digitable), cuando usa el segmento 9, 0 u 8, cuando el tamaño no corresponde con el primer dígito (47 posiciones comenzando con 8, 48 que no comienzan con 8), o cuando es una guía de FGTS (segmento 5 con convenio 0181 o 0182 en las posiciones 16 a 19).
Requisitos previos
payment_account_uid es obligatorio y define la cuenta financiera de origen. financial_account_uid no se acepta en este endpoint.
amount es opcional cuando el código trae el valor a pagar: recaudación con identificador de valor 6 u 8 (3ª posición) y boleto con valor distinto de cero. Sin amount, el pago usa el valor del código; en el boleto, es el valor nominal, sin intereses, multa ni descuento. Es obligatorio en la recaudación con identificador 7 o 9, en la que el valor del código es solo de referencia, y cuando el código viene con valor cero.
Eventos de Webhook
El evento payment.db.created se dispara en esta operación.
Request
Responses
- 201
- 401
- 422
Pago de boleto creado
Error de autenticación. Token inválido
Código con valor de referencia, sin amount