Sobre os status de transações via API

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.