Criar um Pagamento por código de barras
POST/v2/payments/barcode
Cria um pagamento a partir só do código de barras ou da linha digitável. O tipo do pagamento é resolvido pelo próprio código, seguindo o layout FEBRABAN v08, e devolvido no campo kind da resposta:
| Código | kind |
|---|---|
47 posições, ou 44 que não começam com 8 | bank_billet |
começa com 8, segmento 2, 3, 4, 6 ou 7 | utility |
começa com 8, segmento 1 ou 5 | tax, com tax.kind = "unknown" e tax.format = "code" |
O código é recusado com 422 quando um dígito verificador não confere (o geral, no boleto e na arrecadação, e os de campo ou de bloco da linha digitável), quando usa o segmento 9, 0 ou 8, quando o tamanho não combina com o primeiro dígito (47 posições começando com 8, 48 que não começam com 8), ou quando é guia de FGTS (segmento 5 com convênio 0181 ou 0182 nas posições 16 a 19).
Pré-requisitos
payment_account_uid é obrigatório e define a conta financeira de origem. financial_account_uid não é aceito neste endpoint.
amount é opcional quando o código traz o valor a pagar: arrecadação com identificador de valor 6 ou 8 (3ª posição) e boleto com valor diferente de zero. Sem amount, o pagamento usa o valor do código; no boleto, é o valor nominal, sem juros, multa ou desconto. É obrigatório na arrecadação com identificador 7 ou 9, em que o valor do código é só de referência, e quando o código vem com valor zerado.
Eventos de Webhook
O evento payment.db.created é disparado nesta operação.
Request
Responses
- 201
- 401
- 422
Pagamento de boleto criado
Falha de autenticação. Token inválido
Código com valor de referência, sem amount