バッチ処理
「 バッチ処理 上記セクションでは、以下の操作をまとめて実行できます:
- 払い戻し: トランザクションの合計または一部の金額を返します。
- トランザクションのキャプチャ: 以前に承認された資金の保持を確認します。
- トランザクションの無効化: 支払いがキャプチャされる前に、承認されたトランザクションをキャンセルします。
このツールは、CSVファイルをアップロードすることで、大量のトランザクションのロードを容易にします。
1. テンプレートをダウンロード#
アップロードされたデータが正しいこと、および必要な形式に従っていることを確認するために、システムは各操作(テンプレート)に対してサンプルCSVファイルを提供します。 このテンプレートには、各サポートされている操作に必要なフィールドが含まれています。
- バッチ処理セクションにアクセスします。
- 実行する操作(返金、キャプチャ、または無効化)に対応するCSVテンプレートをダウンロードします。
- テンプレートを、処理するトランザクションのデータで入力します。 入力された値が各列の形式に従っていることを確認してください。
払い戻し
返金のテンプレートの表は以下の通りです。
| フィールド名 | Type | 説明 |
|---|---|---|
| batch_id | ヘッダー | ユーザーによって割り当てられた一意の識別子。 これは、バッチごとに繰り返すことはできません。 (数値) |
| transaction_type | ヘッダー | 返金テンプレートの場合、この値は refund |
| reason | ヘッダー | El usuario puede especificar, por lote, una razón para la operación. (por ejemplo, cancelación de vuelo) |
| transaction_id | row | 返金するトランザクションの一意の識別子。 |
| currency | row | トランザクション通貨 (例: USD, MXN)。 |
| amount_to_refund | row | 返金額 (合計または一部)。 小数値を必ず含めてください。 カンマまたはピリオドを使用しないでください。 (例: 1226.00 USD、金額 122600 を入力) |
キャプチャ
キャプチャのトランザクションのテンプレートは以下の通りです。
| フィールド名 | Type | 説明 |
|---|---|---|
| batch_id | ヘッダー | ユーザーによって割り当てられた一意の識別子。 これは、バッチごとに繰り返すことはできません。 (数値) |
| transaction_type | ヘッダー | キャプチャテンプレートの場合、この値は capture |
| transaction_id | row | 返金するトランザクションの一意の識別子。 |
| currency | row | トランザクション通貨 (例: USD, MXN)。 |
| amount_to_refund | row | 返金額 (合計または一部)。 小数値を必ず含めてください。 カンマまたはピリオドを使用しないでください。 (例: 1226.00 USD、金額 122600 を入力) |
無効化
無効化のトランザクションのテンプレートは以下の通りです。
| フィールド名 | Type | 説明 |
|---|---|---|
| batch_id | ヘッダー | ユーザーによって割り当てられた一意の識別子。 これは、バッチごとに繰り返すことはできません。 (数値) |
| transaction_type | ヘッダー | 無効化テンプレートの場合、この値は void |
| transaction_id | row | 返金するトランザクションの一意の識別子。 |
2. ファイルをアップロード#
DEUNA Adminに、入力されたCSVファイルをアップロードします。
- [Go to] バッチ処理.
- クリック バッチのアップロード
- ファイルアップロードの名前を割り当てます。
- CSVファイルをアップロード
- クリック 検証.
3. バッチの結果を確認#
ファイルの状態は以下の通りです。
| Estado | 説明 | 必要なアクション |
|---|---|---|
| 検証 | ファイルがアップロードされ、検証中です。 | Wait. |
| 修正のために | ファイルには手動での修正が必要なエラーが含まれています。 | エラーを修正し、ファイルを再アップロードしてください。 |
| 拒否 | ファイルは検証に失敗しました。 | 示されたエラーを確認し、修正してファイルを再アップロードしてください。 |
| 処理中 | ファイルは検証に成功し、処理中です。 | 処理の完了をお待ちください。 |
| 完了 | ファイル処理が完了しました。 | レスポンスファイル内の結果を確認してください。 |
ファイルのエラー
エラーの詳細を含むファイル(ファイルごとまたはトランザクションごと)をダウンロードしてください。
以下の表は、エラーとそのカテゴリを文書化しています。
| カテゴリ | エラー名 | 説明 | エラーコード |
|---|---|---|---|
| WrongFileFormat | EmptyRow | 操作を実行するために必要な空のフィールドです。 | BT1 |
| WrongFileArguments | EmptyRow | 操作を実行するために必要な空のフィールドです。 | BT2 |
| WrongFileFormat | WrongRowFormat | 列の形式が正しくありません。 | BT3 |
| WrongFileFormat | MissingBatchIDHeader | Batch IDはヘッダーに含める必要があります。 | BT4 |
| WrongFileFormat | MissingTransactionTypeHeader | トランザクションの種類はヘッダーに含める必要があります。 | BT5 |
| WrongFileFormat | MissingEmptyRow | ファイルの2行目は空である必要があります。テンプレートをダウンロードすることをお勧めします。 | BT6 |
| WrongFileFormat | MissingDataRowsHeader | 必要なテンプレートヘッダーを含める必要があります。 | BT7 |
| WrongFileFormat | MissingOrderTokenHeader | Transaction IDはヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。 | BT8 |
| WrongFileFormat | MissingCurrencyHeader | Currencyはヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。 | BT9 |
| WrongFileFormat | MissingAmountToCaptureHeader | amount_to_capture はヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。 | BT10 |
| WrongFileFormat | MissingAmountToRefundHeader | amount_to_refund はヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。 | BT11 |
| WrongFileArguments | InvalidBatchID | Batch IDは無効です。 | BT12 |
| WrongFileArguments | InvalidTransactionType | 入力されたトランザクションタイプが無効です。 | BT13 |
| WrongFileFormat | InvalidOrderToken | 入力されたトランザクションIDが無効です。 | BT14 |
| WrongFileFormat | InvalidCurrency | 入力された通貨が無効です。 | BT15 |
| WrongFileFormat | InvalidAmount | 入力された金額が無効です。 | BT16 |
| WrongFileFormat | CurrencyHeaderShouldBeEmpty | Voidテンプレートファイルにはヘッダーに通貨を含めることはできません。テンプレートをダウンロードすることをお勧めします。 | BT17 |
| WrongFileFormat | CurrencyShouldBeEmpty | Voidテンプレートファイルにはヘッダーに通貨値を含めることはできません。テンプレートをダウンロードすることをお勧めします。 | BT18 |
| WrongFileFormat | AmountHeaderShouldBeEmpty | Voidテンプレートファイルにはヘッダーに金額を含めることはできません。テンプレートをダウンロードすることをお勧めします。 | BT19 |
| WrongFileFormat | AmountShouldBeEmpty | 空のテンプレートファイルには金額の値をヘッダーに含めるべきではありません。テンプレートのダウンロードをお勧めします。 | BT20 |