Pular para o conteúdo principal

Como usar a API de Criar Pagamentos?

Criando Pagamentos com a API

Nós disponibilizamos o endpoint /api/v1/payment para que você possa criar um novo payment para a respectiva empresa afiliada.

Você pode acessar aqui a documentação referente a esse endpoint.

Como parte do body da requisição, esperamos o envio dos seguintes itens: value, destinationAlias, correlationID, e um valor opcional comment:

  • value: O valor em centavos do pagamento a ser criado.
  • destinationAlias: A chave pix destinatária do pagamento criado.
  • correlationID: Um identificador único para o pagamento.
  • comment: Comentário que será atrelado a seu pagamento quando a transferencia for realizada.

Num exemplo prático, o body da sua requisição seguiria semelhante a este exemplo:

{
"value": 100,
"destinationAlias": "38763885700",
"correlationID": "31ee9576-99ec-412a-9ac7-e142a4a6acf0",
"comment": "um comentário"
}

Após efetuar a requisição, se tudo ocorreu bem, o status code da requisição será 2xx e no body da resposta, você estará vendo as informações sobre o payment recém criado.

Num exemplo, essa será a nossa resposta:

{
"payment": {
"value": 100,
"destinationAlias": "38763885700",
"correlationID": "31ee9576-99ec-412a-9ac7-e142a4a6acf0",
"comment": "um comentário",
"status": "CREATED"
}
}