Transações
Para transações aprovadas, a API enviará um postback no seguinte formato JSON. Esse postback contém informações detalhadas sobre a transação, incluindo o ID da transação, o status, o método de pagamento, o valor e as datas associadas aos diferentes estados da transação. Aqui está um exemplo de um postback de transação aprovada:
{
"type": "PAYMENT",
"transactionId": "PRO520350906631159",
"status": "PAID",
"paymentMethod": "PIX",
"amount": 500,
"createdAt": "2024-10-21T15:40:03.874Z",
"updatedAt": "2024-10-21T15:57:10.275Z",
"approvedAt": "2024-10-21T15:57:10.273Z"
}
Em caso de reembolso, a API enviará um postback. O status da transação será "REFUND".
{
"type": "PAYMENT",
"transactionId": "PRO520350906631159",
"status": "REFUND",
"paymentMethod": "PIX",
"amount": 200,
"createdAt": "2024-09-20T05:48:29.599Z",
"updatedAt": "2024-09-20T05:48:29.937Z",
"approvedAt": null
}
Transfêrencias
Para saques realizados via PIX, a API enviará postbacks para notificar sobre o status da transação. Abaixo estão os exemplos de postbacks para saques aprovados e para casos de falha.
Postback de Saque Aprovado
Quando um saque é aprovado, a API enviará um postback com as informações relevantes, como o ID da transação, o método de pagamento, o valor e as datas associadas ao saque. O status da transação será "PAID" nesse caso.
{
"type": "WITHDRAW",
"transactionId": "PRO733340707023927",
"status": "WITHDRAW_PAID",
"paymentMethod": "PIX",
"amount": 200,
"createdAt": "2024-10-21T05:08:53.366Z",
"updatedAt": "2024-10-21T15:57:11.194Z",
"approvedAt": "2024-10-21T15:57:11.193Z"
}
Postback de Saque com Erro
Em caso de erro durante a tentativa de saque, a API enviará um postback informando o motivo da falha. O status da transação será "ERROR" e o campo failureReason fornecerá mais detalhes sobre o erro..
{
"type": "WITHDRAW",
"transactionId": "PRO520350906631159",
"status": "ERROR",
"failureReason": "O PIX de destino está na lista de bloqueio. Entre em contato com o suporte",
"paymentMethod": "PIX",
"amount": 200,
"createdAt": "2024-09-20T05:48:29.599Z",
"updatedAt": "2024-09-20T05:48:29.937Z",
"approvedAt": null
}
Sub contas
A API enviará um postback para o endpoint configurado sempre que uma subconta for aprovada ou rejeitada. Esse postback contém informações detalhadas sobre o status da subconta, incluindo o ID da subconta, o status atual, e a data e hora da alteração.
Postback para Subconta Aprovada
{
"type": "SUB_USER",
"userId": "1ffba03d-6c12-4f5e-8994-93e8c33234ae",
"accountStatus": "APPROVED",
"createdAt": "2024-09-20T05:48:29.599Z",
"updatedAt": "2024-09-20T05:48:29.937Z",
"approvedAt": "2024-09-20T05:48:29.937Z"
}
Postback para Subconta Rejeitada
{
"type": "SUB_USER",
"userId": "1ffba03d-6c12-4f5e-8994-93e8c33234ae",
"accountStatus": "DECLINED",
"createdAt": "2024-12-30T16:56:57.323Z",
"updatedAt": "2024-12-30T17:01:10.590Z",
"rejectedAt": "2024-12-30T17:02:22.568Z",
"rejectType": 3
}
O campo rejectType indica o motivo da rejeição de uma subconta. Ele é enviado no postback quando o status da subconta é rejected e contém um código numérico correspondente a uma das categorias descritas abaixo.
Tipos de Rejeição e Motivos
0: Documentos inválidos
Motivo: Os documentos enviados são ilegíveis, estão fora do prazo de validade ou não atendem aos critérios exigidos.
1: Possível fraude
Motivo: Há indícios de fraude, como discrepâncias nos dados fornecidos ou suspeita de informações falsas.
2: Dados incompletos
Motivo: O cliente não forneceu todas as informações necessárias para a criação da conta. Isso pode incluir campos obrigatórios não preenchidos.
3: Dados incompatíveis
Motivo: Os dados fornecidos não correspondem ou são incompatíveis com registros existentes (exemplo: nome não corresponde ao número do CPF).
4: Idade mínima não atingida
Motivo: O usuário não atingiu a idade mínima exigida para a criação da subconta (exemplo: abaixo de 18 anos).
5: País não suportado
Motivo: O país do cliente não está entre os países suportados pelo sistema para criação de subconta.
6: Problema técnico
Motivo: Um erro técnico ocorreu durante o processo de verificação da conta (por exemplo, falha no sistema de validação de documentos).
7: Limite de criação de contas atingido
Motivo: O usuário atingiu o número máximo de subcontas permitidas no sistema, impedindo a criação de uma nova subconta.
8: Restrição de segurança
Motivo: A conta foi rejeitada devido a uma política de segurança interna, como tentativas excessivas de login ou atividade suspeita.
9: Outros motivos
Motivo: A rejeição ocorreu por motivos não especificados. Para mais informações, entre em contato com o suporte.