Nesta seção, você aprenderá como criar um pagamento associado a uma Pré-autorização de Transferência Inteligente.
Para criar um pagamento, você precisa fazer a seguinte solicitação:
curl --location 'https://api.pluggy.ai/smart-transfers/payments' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: ••••••' \
--data '{
"preauthorizationId": "7e3e1dbb-8009-4966-9254-1eaab05ad18b",
"recipientId": "ded2e966-bd40-4e82-b467-d32fe4b4f40e",
"amount": 100,
"description": "Meu pagamento automático"
}'Vamos analisar os campos que precisamos enviar:
preauthorizationId: É o id da pré-autorização que criamos na seção anterior.recipientId: É um dos destinatários que autorizamos para a pré-autorização dada. Outros destinatários serão rejeitados.amount: O valor que você deseja enviar.description: Uma descrição opcional para enviar com a transferência.
Para mais detalhes sobre este endpoint, consulte a documentação da API.
Isso retornará o seguinte:
{
"id": "b2b132f7-4c17-4707-bd5d-197d71d01385",
"preauthorizationId": "7e3e1dbb-8009-4966-9254-1eaab05ad18b",
"status": "CONSENT_AUTHORIZED",
"amount": 100,
"description": "Meu pagamento automático",
"recipient": {
"type": "BANK_ACCOUNT",
"id": "ded2e966-bd40-4e82-b467-d32fe4b4f40e",
"name": "John Doe",
"taxNumber": "11111111111",
"isDefault": false,
"paymentInstitution": {
"id": "abfd2a88-bc7b-407f-9fcc-395548ee6840",
"name": "Banco XP S.A.",
"tradeName": "BCO XP S.A.",
"ispb": "33264668",
"compe": "348",
"createdAt": "2023-12-08T17:52:21.001Z",
"updatedAt": "2023-12-08T17:52:21.001Z"
},
"account": {
"type": "CHECKING_ACCOUNT",
"number": "1111111",
"branch": "0001"
},
"pixKey": null,
"createdAt": "2024-07-31T15:56:03.938Z",
"updatedAt": "2024-07-31T15:56:23.123Z"
},
"createdAt": "2024-08-01T17:03:12.278Z",
"updatedAt": "2024-08-01T17:03:15.419Z",
"clientPaymentId": null
}Você pode usar este endpoint para saber quando o pagamento é concluído (geralmente leva alguns segundos). Se tudo estiver ok, o status do pagamento será PAYMENT_COMPLETED.
Sobre limites de transferência
As Transferências Inteligentes são categorizadas como um Pix Imediato entre diferentes contas do mesmo titular. Portanto, os limites definidos no consentimento para este produto devem ser tratados da mesma forma que a instituição aplica os limites do arranjo do Pix.
O cálculo do limite periódico disponível para o cliente deve seguir as diretrizes abaixo, considerando diferentes cenários e exemplos:
Limite Diário (ex: R$ 100,00): Este limite controla transferências feitas dentro de um único dia, considerando o período de 00:00 a 23:59. Por exemplo, se um usuário transfere R$ 50,00 às 10:00, ele ainda terá R$ 50,00 disponíveis para transferências até a meia-noite do mesmo dia;
Limite Semanal (ex: R$ 1.000,00): O limite semanal cobre o período de uma semana inteira, começando às 00:00 de domingo e terminando às 23:59 de sábado. Por exemplo, se um usuário transfere R$ 200,00 na terça-feira e R$ 500,00 na quinta-feira, ele ainda terá R$ 300,00 disponíveis para transferências até o final de sábado;
Limite Mensal (ex: R$ 10.000,00): Este limite mensal é calculado do primeiro ao último dia de cada mês. Por exemplo, em um mês, se o usuário transfere R$ 2.000,00 na primeira semana e R$ 3.000,00 na segunda semana, ele ainda terá R$ 5.000,00 disponíveis para transferências pelo resto do mês;
Limite Anual (ex: R$ 50.000,00): O limite anual conta do primeiro dia de janeiro até o último dia de dezembro. Por exemplo, se um usuário transfere R$ 10.000,00 até março, mais R$ 15.000,00 até junho, e mais R$ 20.000,00 até setembro, ele só poderá transferir mais R$ 5.000,00 até o final do ano.
Esses limites ajudam a gerenciar transferências de fundos, garantindo que não excedam os valores estabelecidos para cada período. Cada limite é independente e é recalculado à medida que sua respectiva janela de tempo se reinicia.