Procurando a documentação anterior?Acesse v1.docs.pluggy.ai
PluggyDocs
POST/payments/requests

Criar

Cria o recurso de solicitação de pagamento

Request Body

required
object

Solicitação com informações para criar uma solicitação de pagamento

amountrequirednumber

Valor solicitado

descriptionstring

Descrição do pagamento

callbackUrlsobject | null
Any of:
option 1object

Redirecionar URLs após o pagamento ser concluído ou encerrado com status de erro

option 2null | null
recipientIdstring (uuid)

Identificador do recebedor de pagamento

customerIdstring (uuid)

Identificador do cliente associado ao pagamento

clientPaymentIdstring

Seu identificador de pagamento

schedulestring | null

Default: null

One of:
option 1object

Agende um atributo para gerar um único pagamento em uma data futura específica.

option 2object

Agende o atributo para gerar pagamentos diários a partir de `startDate`.

option 3object

Agende o atributo para gerar pagamentos semanais em um dia específico da semana.

option 4object

Agende o atributo para gerar pagamentos mensais em um dia específico do mês.

option 5object

Agende o atributo para gerar pagamentos em uma lista explícita de datas.

isSandboxboolean

Indica se este pedido de pagamento deve ser criado no modo sandbox. Padrão: falso.

Default: false

Example

json
{
  "amount": 100.5,
  "description": "Transferência"
}

Responses

200Sucesso ao criar solicitação de pagamento
object

Resposta com informações relacionadas a uma solicitação de pagamento

idrequiredstring

Identificador principal

amountnumber

Valor solicitado. Para pix automático, não será devolvido.

feesnumber | null

Taxas cobradas pela solicitação de pagamento. Isso inclui tanto as taxas da Pluggy quanto quaisquer taxas específicas do cliente. As taxas são calculadas com base no método de pagamento (PIX ou Boleto) e na configuração de preços do cliente. Para contas de sandbox, as taxas são definidas como 0.

descriptionstring

Descrição do pagamento

statusrequiredstring

Ciclo de vida de uma solicitação de pagamento. - `CREATED`: a solicitação foi criada e está aguardando uma intenção de pagamento. - `IN_PROGRESS`: uma intenção de pagamento está sendo processada pela instituição. - `WAITING_PAYER_AUTHORIZATION`: o pagador deve autorizar o pagamento na instituição. - `AUTHORIZED`: apenas para PIX Automático. O consentimento recorrente foi autorizado; pagamentos individuais serão executados sob ele. - `SCHEDULED`: o pagamento está agendado para uma data futura. - `COMPLETED`: o pagamento foi confirmado pela instituição. - `ERROR`: o pagamento falhou (veja `errorDetail`). - `REFUND_IN_PROGRESS`: um reembolso foi solicitado e está sendo processado. - `REFUNDED`: o reembolso foi concluído. - `REFUND_ERROR`: o reembolso falhou. - `EXPIRED`: a solicitação expirou sem ser paga. - `CANCELED`: a solicitação foi cancelada.

CREATEDIN_PROGRESSWAITING_PAYER_AUTHORIZATIONAUTHORIZEDSCHEDULEDCOMPLETEDERRORREFUND_IN_PROGRESSREFUNDEDREFUND_ERROREXPIREDCANCELED
clientPaymentIdstring | null

Identificador de pagamento do cliente

createdAtrequiredstring (date-time)

Data em que a solicitação de pagamento foi criada

updatedAtrequiredstring (date-time)

Data em que o pedido de pagamento foi atualizado

callbackUrlsobject | null
Any of:
option 1object

Redirecionar URLs após o pagamento ser concluído ou encerrado com status de erro

option 2null | null
recipientobject | null

Destinatário do pagamento. A forma depende do `tipo` do destinatário.

Any of:
option 1object

Destinatário incorporado dentro de uma solicitação de pagamento. Polimórfico dependendo do tipo de pagamento. - `BANK_ACCOUNT`: um destinatário de conta bancária registrada (veja `PaymentRecipient`). - `PIX_QR_CODE`: destinatário derivado de um código QR PIX anexado à solicitação. - `BOLETO`: destinatário derivado de um boleto anexado à solicitação.

option 2null | null
customerobject | null

Cliente associado à solicitação de pagamento

Any of:
option 1object

Resposta com informações relacionadas a um cliente de pagamento

option 2null | null
smartAccountobject | null

Conta inteligente que recebe os fundos, quando aplicável

Any of:
option 1object

Conta Pluggy Smart (conta de custódia) vinculada a uma solicitação de pagamento. Recebe fundos e permite que o cliente orquestre divisões e retiradas.

option 2null | null
paymentUrlrequiredstring

URL para iniciar o fluxo de criação de intenção de pagamento para esta solicitação de pagamento

pixQrCodestring | null

Código QR Pix gerado pelo recebedor do pagamento

boletoobject | null
Any of:
option 1object

Dados do Boleto

option 2null | null
automaticPixobject

Dados automáticos do PIX

fixedAmountnumber

Valor fixo da cobrança; se preenchido, representa consentimento para pagamentos de valores fixos, não sujeitos a alteração durante a validade do consentimento. Se enviado, minimumVariableAmount e maximumVariableAmount não podem ser fornecidos.

minimumVariableAmountnumber

Valor mínimo permitido por cobrança; se preenchido, representa consentimento para pagamentos de valores variáveis. Se enviado, fixedAmount não pode ser fornecido.

maximumVariableAmountnumber

Valor máximo permitido por cobrança; se preenchido, representa consentimento para pagamentos de valores variáveis. Se enviado, fixedAmount não pode ser fornecido.

startDaterequiredstring (date-time)

Representa a data esperada para a primeira ocorrência de um pagamento associado à recorrência.

expiresAtstring (date-time)

Data de expiração para a autorização automática de pix

isRetryAcceptedboolean

Indica se o cliente receptor tem permissão para fazer tentativas de pagamento, de acordo com as regras estabelecidas no arranjo do Pix.

firstPaymentobject

Definições para o primeiro pagamento. É considerado como o pagamento de inscrição do usuário para o serviço.

intervalrequiredstring

Frequência permitida para pagamentos recorrentes de PIX sob um consentimento.

WEEKLYMONTHLYQUARTERLYSEMESTERYEARLY
automaticRetriesConfigurationobject

Configuração para tentativas automáticas. Se fornecido, os pagamentos agendados associados a este consentimento serão tentados novamente apenas nos dias especificados na matriz após a data do pagamento original. Isso não se aplica ao primeiro pagamento, apenas para pagamentos agendados.

schedulerConfigurationobject

Configuração para agendamento automático de pagamentos. Quando ativado, o sistema agendará pagamentos de acordo com o intervalo de consentimento e a data de início.

scheduleobject
One of:
option 1object

Agende um atributo para gerar um único pagamento em uma data futura específica.

option 2object

Agende o atributo para gerar pagamentos diários a partir de `startDate`.

option 3object

Agende o atributo para gerar pagamentos semanais em um dia específico da semana.

option 4object

Agende o atributo para gerar pagamentos mensais em um dia específico do mês.

option 5object

Agende o atributo para gerar pagamentos em uma lista explícita de datas.

option 6null | null
errorDetailobject | null

Detalhes do erro quando a solicitação de pagamento falha

codestring

Error code

providerMessagestring

Error message returned by the institution

isSandboxboolean

Indica se esta solicitação de pagamento está no modo sandbox. Padrão: falso.

Default: false

Example response

json
{
  "id": "05c693bf-c196-47ea-a28c-8251d6bb8a06",
  "amount": 100.5,
  "description": "Transferência",
  "status": "CREATED",
  "createdAt": "2023-11-06T13:03:45.689Z",
  "updatedAt": "2023-11-06T13:03:45.689Z",
  "callbackUrls": null,
  "paymentUrl": "https://pay.pluggy.ai/05c693bf-c196-47ea-a28c-8251d6bb8a06",
  "isSandbox": false
}
curl -X POST \
  'https://api.pluggy.ai/payments/requests' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -d '{ "amount": 100.5, "description": "Transferência" }'
Resposta de exemplo
{
  "id": "05c693bf-c196-47ea-a28c-8251d6bb8a06",
  "amount": 100.5,
  "description": "Transferência",
  "status": "CREATED",
  "createdAt": "2023-11-06T13:03:45.689Z",
  "updatedAt": "2023-11-06T13:03:45.689Z",
  "callbackUrls": null,
  "paymentUrl": "https://pay.pluggy.ai/05c693bf-c196-47ea-a28c-8251d6bb8a06",
  "isSandbox": false
}