Geração de uma forma de pagamento

Este endpoint permite a geração de uma forma de pagamento para uma fatura específica, por meio do seu identificador único (statementId).

📘
Nota
Para gerar uma forma de pagamento, a fatura já deve estar fechada (cycleType = Closed).

As formas de pagamento podem ser:

Total;
Parcelado com entrada;
Parcial:
- Pagamento mínimo;
- Pagamento em atraso.

👍
Dica
Para mais informações sobre as formas de pagamento de uma fatura, consulte a Visão geral desta documentação.

Pré-requisito

Para que seja possível utilizar este endpoint, é necessário que o cliente do parceiro Bankly:

Possua opções de pagamento geradas para a fatura. As opções de pagamento podem ser consultadas pelo endpoint de consulta de opções de pagamento (api-version 1.0).

Requisição (Request)

Requisição HTTP

POST https://api-mtls.sandbox.bankly.com.br/cards/invoices/{statementId}/payment

--request POST \ 
--url 'https://api-mtls.sandbox.bankly.com.br/cards/invoices/{statementId}/payment' \ 
--header 'Authorization:  Bearer {Token}'\ 
--header 'accept: application/json' \ 
--header 'api-version: 2' \ 
--header 'content-type: application/json'\
--header ' idempotency-key: 1e17fdb6-592f-4cbd-9403-e3f28694be82 ' \ 
--header 'x-correlation-id: GUID' \
--data '{
     "paymentType": "Partial", 
     "amount": { 
          "value": 0.0, 
          "currency": "BLR", 
     }, 
     "paymentOptionId": 0 
}'

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.

Esta requisição requer o scope descrito a seguir:

Scope	Descrição
`invoice.write`	Concede acesso para gerar uma forma de pagamento de uma fatura.

Cabeçalhos (Headers)

Nome	Descrição
`api-version`	Obrigatório. Versão da API, que, neste caso, é 2.0.
`Authorization`	Obrigatório. Token de autorização do tipo Bearer.
`idempotency-key`	Obrigatório. Chave de idempotência, sendo uma nova a cada requisição. Em caso de retry, deve-se enviar a mesma.
`x-correlation-id`	Informe um GUID, sendo um novo cada requisição.

Parâmetros da rota (Path)

No path desta requisição, envie o seguinte campo:

Nome	Tipo	Descrição
`statementId`	`path`	Obrigatório. Identificador único da fatura.

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

Nome	Tipo	Descrição
`paymentType`	`string`	Obrigatório. Opção de pagamento, que pode ser “Cash” (à vista), “Partial” (parcial), “InstallmentWithEntry” (parcelado com entrada) e “InstallmentWithoutEntry” (parcelado sem entrada).
`amount`	`object`	Objeto que deverá conter informações sobre o valor da transação. Este objeto e suas propriedades são obrigatórias somente se o tipo de pagamento escolhido for “Partial”.
`amount.value`	`number`	Valor a ser pago.
`amount.currency`	`string`	Código da moeda com base na ISO-4217. Exemplo: "BRL".
`paymentOptionId`	`int`	Identificador da opção de pagamento. Este campo é obrigatório somente se o tipo de pagamento escolhido for “InstallmentWithEntry”. O identificador poderá ser obtido por meio do endpoint de consulta das opções de pagamento.

{ 
     "paymentType": "Partial", 
      "amount": { 
          "value": 0.0, 
          "currency": "BLR", 
     }, 
     "paymentOptionId": 0 
}

📘
Nota
Um pagamento pode ser efetivado em até dois dias úteis, devido ao tempo de liquidação do boleto.

Resposta (Response)

O status code 202 indicará que a forma de pagamento está sendo criada e retornará um objeto com os dados da forma de pagamento escolhida.
Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:

Nome	Tipo	Descrição	Número máximo de caracteres
`authenticationCode`	`string`	Identificador da forma de pagamento.	40

{ 
  "authenticationCode": "string" 
}

👍
Dica
Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

Este endpoint pode retornar alguns erros específicos, conforme a tabela a seguir:

Status Code	Código	Mensagem	Descrição
400	CONTRACT_IS_IN_CRELIQ	Contract from statment is Creliq status.	Contrato da declaração está em status Creliq.
400	CONTRACT_IS_IN_PRE_CRELIQ	Contract in precreliq can not make installment payment.	Contrato em pré-creliq não pode fazer pagamento de parcela.
400	CONTRACT_IS_IN_PRE_CRELIQ	Contract in pre creliq can not have payment less than minimal.	Contrato em pré-creliq não pode ter pagamento menor que o mínimo.
406	STATEMENT_IS_NOT_CLOSED	Statement is not closed!	A fatura não está fechada.
406	PAYMENT_TYPE_VALUE_NOT_ALLOWED	The partial payment amount must be less than the invoice amount!	O valor do pagamento parcial deve ser menor que o valor da fatura.
406	PAYMENT_TYPE_AMOUNT_MINIMAL_NOT_ALLOWED	The partial payment amount cannot be less than the minimum amount configured for issuing a bank slip.	O valor do pagamento parcial não pode ser inferior ao valor mínimo configurado para emissão de boleto bancário. Caso necessite ajustar o limite configurado, abra um chamado no Service Desk.
406	STATEMENT_CAN_BE_NOT_PAID_AGAIN	The Statement Can Be Not Paid Again.	A declaração não pode ser paga novamente.

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints. Portanto, recomendamos a consulta da documentação de erros, onde é possível encontrar as mensagens comuns em inglês que acompanham os erros 400.

Eventos

Caso o parceiro deseje receber mensagens referentes aos eventos relacionados a esse endpoint, é preciso configurar o webhook. O evento é:

Nome do evento	Descrição
`INVOICE_PAYMENT_OPTION_CREATED`	Opção de pagamento de fatura criada.

📘
Nota
Para obter informações sobre o evento INVOICE_PAYMENT_OPTION_CREATED, acesse a versão 1 desta documentação, clicando no menu superior direito.