Criar agendamento único
Este endpoint permite que o usuário pagador possa criar um agendamento de um pagamento.
Requisição (Request)
Requisição HTTP
POST https://api-mtls.sandbox.bankly.com.br/pix/scheduling-paymentscurl --request POST \
--url https://api-mtls.sandbox.bankly.com.br/pix/scheduling-payments \
--header 'accept: application/json' \
--header 'api-version: 1' \
--header 'content-type: application/json'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 |
|---|---|
pix.schedule-payment.write | Concede acesso para criar um agendamento de pagamento. testeste |
Cabeçalhos (Headers)
| Nome | Descrição | Especificação |
|---|---|---|
api-version | Obrigatório. Versão da API. Atualmente estamos na versão 1. | — |
Authorization | Obrigatório. Token de autorização do tipo Bearer. | — |
x-bkly-pix-user-id | Obrigatório. Número do documento do usuário que está fazendo a requisição. | Informe somente números. |
Parâmetros da rota (Path)
Não é necessário enviar campos no path desta requisição.
Corpo da requisição (Body)
No body, envie o seguinte campo em formato JSON:
Nome | Tipo | Descrição | Especificação |
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Exemplo: |
|
|
|
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
|
|
|
|
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Resposta (Response)
O status code 201 indicará sucesso na criação do agendamento.
Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:
| Nome | Tipo | Descrição |
|---|---|---|
requestIdentifier | string | Identificador do agendamento. |
message | string | Mensagem de sucesso. |
{
"requestIdentifier": "E9999901012341234123412345678900",
"message": "Agendamento cadastrado com sucesso"
}
DicaPara simular uma requisição nesse endpoint, acesse o API Reference.
Erros
Status code | Código | Mensagem | Descrição |
|---|---|---|---|
400 | INVALID_PARAMETER | Algum parâmetro não foi informado corretamente. | |
403 | INVALID_LICENSE | Invalid license. | A licença informada está fora do padrão ou não existe. |
422 | RECURRENCE_REPROVED | The recurrence request could not be processed. | A solicitação de recorrência não pôde ser processada. |
422 | BUSINESS_RULE_VIOLATED | A mensagem a ser retornada está na tabela abaixo. | Este erro pode retornar por vários motivos. |
422 | END_TO_END_ID_NOT_FOUND | No decode or entry request associated with this EndToEndId was found. | Nenhuma solicitação de decodificação ou consulta de chave associada a este EndToEndId foi encontrada. |
422 | INCORRECT_END_TO_END_ID_OR_INITIATION_FORM | EndToEndId with this InitiationForm not found. | EndToEndId com o InitiationForm informado não foi encontrado. |
500 | UNEXPECTED_ERROR | An unexpected result occurred during the operation | Ocorreu um erro inesperado. |
503 | SERVICE_UNAVAILABLE | Service unavailable. |
code | messages |
|---|---|
BUSINESS_RULE_VIOLATED | "Infelizmente, não foi possível aprovar a solicitação (Motivo: o campo recurrence.requestIdentifier já existe" |
BUSINESS_RULE_VIOLATED | "Infelizmente não foi possível aprovar a solicitação (Motivo: transação não concluída. Erro de processamento" |
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 (se houver).
Eventos
Este endpoint não possui eventos relacionados a ele.
Updated 13 days ago
