Processamento em lote
No Processamento em lote seção, você pode executar operações em massa para:
- Reembolsos: Retorna o valor total ou parcial de uma transação.
- Capturas de transações: Confirme a retenção de fundos previamente autorizados.
- Anulações de transação: Cancele uma transação autorizada antes que o dinheiro seja capturado.
Esta ferramenta facilita o carregamento de um grande volume de transações através do upload de um arquivo CSV.
1. Baixe o modelo#
Para garantir que os dados carregados estejam corretos e sigam o formato exigido, o sistema oferece um arquivo CSV de amostra para cada operação (template). Este modelo contém os campos necessários para cada operação suportada.
- Acesse a seção Processamento em lote.
- Baixe o modelo CSV correspondente à operação que deseja realizar (reembolso, captura ou anulação).
- Preencha o modelo com os dados das transações que deseja processar. Certifique-se de que os valores inseridos respeitam o formato de cada coluna.
Reembolsos
A tabela a seguir mostra o modelo de reembolso:
| Nome do campo | Tipo | Descrição |
|---|---|---|
| batch_id | cabeçalho | Identificador único atribuído pelo usuário, não podendo ser repetido por lote. (Numérico) |
| transaction_type | cabeçalho | No caso do modelo de reembolso, o valor deverá ser refund |
| razão | cabeçalho | O usuário pode especificar, por lote, um motivo para a operação. (por exemplo, cancelamento de voo) |
| transaction_id | linha | Identificador único da transação a ser reembolsada. |
| moeda | linha | Moeda da transação (por exemplo, USD, MXN). |
| amount_to_refund | linha | Valor a reembolsar (parcial ou total). O valor em centavos deve ser incluído, sem vírgulas ou pontos. (por exemplo, 1226,00 USD, o valor 122600 deve ser inserido) |
Capturas
A tabela a seguir define o modelo para captura de pagamentos:
| Nome do campo | Tipo | Descrição |
|---|---|---|
| batch_id | cabeçalho | Identificador único atribuído pelo usuário, não podendo ser repetido por lote. (Numérico) |
| transaction_type | cabeçalho | No caso do modelo de captura, o valor deve ser capture |
| transaction_id | linha | Identificador único da transação a ser reembolsada. |
| moeda | linha | Moeda da transação (por exemplo, USD, MXN). |
| amount_to_refund | linha | Valor a reembolsar (parcial ou total). O valor em centavos deve ser incluído, sem vírgulas ou pontos. (por exemplo, 1226,00 USD, o valor 122600 deve ser inserido) |
Vazios
A tabela a seguir definiu o modelo para pagamentos anulados:
| Nome do campo | Tipo | Descrição |
|---|---|---|
| batch_id | cabeçalho | Identificador único atribuído pelo usuário, não podendo ser repetido por lote. (Numérico) |
| transaction_type | cabeçalho | No caso do modelo void, o valor deve ser void |
| transaction_id | linha | Identificador único da transação a ser reembolsada. |
2. Carregue o arquivo#
Carregue o arquivo CSV completo no DEUNA Admin:
- Acessar Processamento em lote.
- Clique Carregar lote
- Atribua um nome para o upload do arquivo.
- Carregar o arquivo CSV
- Clique Validar.
3. Revise os resultados do lote#
Os possíveis status do arquivo são os seguintes:
| Estado | Descrição | Ação necessária |
|---|---|---|
| Validando | O arquivo foi carregado e está sendo validado. | Wait. |
| Para resolver | O arquivo contém erros que requerem intervenção manual. | Corrija os erros e reenvie o arquivo. |
| Rejeitado | O arquivo falhou na validação. | Revise e corrija os erros indicados e carregue novamente o arquivo. |
| Processamento | O arquivo passou na validação e está sendo processado. | Aguarde o término do processamento. |
| Concluído | O processamento do arquivo foi concluído. | Revise os resultados no arquivo de resposta. |
Erros de arquivo
Baixe um arquivo com os detalhes do erro por arquivo ou por transação se o arquivo contiver erros.
A tabela a seguir documenta os possíveis erros e suas categorias:
| Categoria | Nome do erro | Descrição | Código de erro |
|---|---|---|---|
| Formato de arquivo errado | Linha Vazia | Campo vazio obrigatório para executar a operação. | BT1 |
| Argumentos de arquivo errados | Linha Vazia | Campo vazio obrigatório para executar a operação. | BT2 |
| Formato de arquivo errado | Formato de linha errado | Formato incorreto em uma coluna. | BT3 |
| Formato de arquivo errado | MissingBatchIDHeader | O ID do lote deve ser incluído no cabeçalho. | BT4 |
| Formato de arquivo errado | MissingTransactionTypeHeader | O tipo de transação deve ser incluído no cabeçalho. | BT5 |
| Formato de arquivo errado | FaltandoEmptyRow | A segunda linha do arquivo deve estar vazia. Recomenda-se baixar o modelo. | BT6 |
| Formato de arquivo errado | MissingDataRowsHeader | Os cabeçalhos de modelo obrigatórios devem ser incluídos. | BT7 |
| Formato de arquivo errado | MissingOrderTokenHeader | O ID da transação deve ser incluído no cabeçalho. Recomenda-se baixar o modelo. | BT8 |
| Formato de arquivo errado | MissingCurrencyHeader | A moeda deve ser incluída no cabeçalho. Recomenda-se baixar o modelo. | BT9 |
| Formato de arquivo errado | MissingAmountToCaptureHeader | amount_to_capture deve ser incluído no cabeçalho. Recomenda-se baixar o modelo. | BT10 |
| Formato de arquivo errado | MissingAmountToRefundHeader | amount_to_refund deve ser incluído no cabeçalho. Recomenda-se baixar o modelo. | BT11 |
| Argumentos de arquivo errados | ID de lote inválido | O ID do lote é inválido. | BT12 |
| Argumentos de arquivo errados | InvalidTransactionType | O tipo de transação inserido é inválido. | BT13 |
| Formato de arquivo errado | Token de pedido inválido | O ID da transação inserido é inválido. | BT14 |
| Formato de arquivo errado | Moeda Inválida | A moeda inserida é inválida. | BT15 |
| Formato de arquivo errado | Valor inválido | O valor inserido é inválido. | BT16 |
| Formato de arquivo errado | CurrencyHeaderShouldBeEmpty | O arquivo de modelo void não deve conter moeda no cabeçalho. Recomenda-se baixar o modelo. | BT17 |
| Formato de arquivo errado | CurrencyShouldBeEmpty | O arquivo de modelo void não deve conter um valor monetário no cabeçalho. Recomenda-se baixar o modelo. | BT18 |
| Formato de arquivo errado | AmountHeaderShouldBeEmpty | O arquivo de modelo nulo não deve conter um valor no cabeçalho. Recomenda-se baixar o modelo. | BT19 |
| Formato de arquivo errado | QuantidadeShouldBeEmpty | O arquivo de modelo void não deve conter um valor de valor no cabeçalho. Recomenda-se baixar o modelo. | BT20 |