Podem fornecer uma lista de todos os status de transação possíveis?
Esta é a lista completa de status possíveis para as operações da API:
- Todos os status de compras (pay-ins): created, confirmed, canceled, failed
- Todos os status de pagamentos (pay-outs): created, completed, pending, canceled, failed
- Todos os status de pagamentos em massa: pending, running, done, failed, completed, queued, canceled
Nota: Recomendamos que os implementadores da API realizem comparações sem distinção de maiúsculas e minúsculas ao verificar os status.
Quais status são considerados finais e quais não são?
Purchase API (API de Compras / Pay-ins)
NÃO FINAL
- Created: Uma ordem de compra foi criada e aguarda a ação do destinatário. Deve ser "confirmed" ou "canceled" pelo destinatário. Compras não concluídas expiram em 15 dias.
FINAL
- Confirmed: O destinatário confirmou (pagou) a ordem de compra e os fundos foram creditados na sua conta.
- Canceled: O destinatário cancelou (recusou) a ordem de compra. Nenhum fundo foi creditado na sua conta.
- Failed: Algo deu errado quando o destinatário tentou confirmar ou cancelar a ordem. Entre em contato com seu Account Manager para localizar os fundos.
Payout API (API de Pagamentos / Pay-outs)
NÃO FINAL
- Created: Uma ordem de pagamento foi criada usando o processo de dois passos e aguarda que você chame o commit endpoint.
- Pending: Uma conta de convidado foi criada para o usuário final com o e-mail do destinatário, e o dinheiro ficará em custódia na Airtm até que o destinatário ative sua conta.
FINAL
- Completed: O pagamento foi concluído com sucesso e os fundos foram creditados na conta Airtm do usuário final.
- Canceled: Você cancelou o pagamento e os fundos foram devolvidos ao seu saldo (aplica-se apenas se o pagamento estava anteriormente em status "pending").
- Failed: Algo deu errado ao processar o pagamento. Entre em contato com seu Account Manager para localizar os fundos.
Bulk Payments API (API de Pagamentos em Massa)
Status de uma tarefa de Pagamento em Massa:
NÃO FINAL
- Pending: A tarefa de pagamento em massa foi criada mas ainda não iniciou.
- Running: Nosso sistema está processando todos os pagamentos individuais do pagamento em massa.
FINAL
- Done: O processamento, as validações e a criação de operações relacionadas à tarefa foram concluídos. Isso não significa que todos os pagamentos individuais foram concluídos com sucesso.
- Failed: Algo deu errado ao processar um ou mais pagamentos individuais. Verifique o endpoint de erros e entre em contato com seu Account Manager se necessário.
Status de pagamentos individuais dentro de um Pagamento em Massa:
NÃO FINAL
- Queued: O pagamento está na fila aguardando ser processado.
- Pending: Uma conta de convidado foi criada para o usuário final e o dinheiro ficará em custódia até que o destinatário ative sua conta Airtm.
FINAL
- Completed: O pagamento foi concluído com sucesso e os fundos foram creditados na conta Airtm do usuário final.
- Canceled: Você cancelou o pagamento e os fundos foram devolvidos ao seu saldo (aplica-se apenas se o pagamento estava em status "pending").
- Failed: Algo deu errado. Verifique o endpoint de erros e entre em contato com seu Account Manager se necessário.
Vocês têm um endpoint para verificar o status e os detalhes de uma transação?
Sim. Para pay-ins e pay-outs use https://docs.airtm.com/operations/get-operation-detail. Para pagamentos em massa: https://docs.airtm.com/bulk-payments/get-bulk-payments-by-id. Você também pode receber callbacks ao usar a API de compras (pay-ins) e a API de pagamentos (pay-outs) para acompanhar os status sem precisar consultar um por um.