メインコンテンツへスキップ
このページで

「 バッチ処理 上記セクションでは、以下の操作をまとめて実行できます:

  • 払い戻し: トランザクションの合計または一部の金額を返します。
  • トランザクションのキャプチャ: 以前に承認された資金の保持を確認します。
  • トランザクションの無効化: 支払いがキャプチャされる前に、承認されたトランザクションをキャンセルします。

このツールは、CSVファイルをアップロードすることで、大量のトランザクションのロードを容易にします。

1. テンプレートをダウンロード#

アップロードされたデータが正しいこと、および必要な形式に従っていることを確認するために、システムは各操作(テンプレート)に対してサンプルCSVファイルを提供します。 このテンプレートには、各サポートされている操作に必要なフィールドが含まれています。

  1. バッチ処理セクションにアクセスします。
  2. 実行する操作(返金、キャプチャ、または無効化)に対応するCSVテンプレートをダウンロードします。
  3. テンプレートを、処理するトランザクションのデータで入力します。 入力された値が各列の形式に従っていることを確認してください。

払い戻し

返金のテンプレートの表は以下の通りです。

フィールド名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_idrow返金するトランザクションの一意の識別子。
currencyrowトランザクション通貨 (例: USD, MXN)。
amount_to_refundrow返金額 (合計または一部)。 小数値を必ず含めてください。 カンマまたはピリオドを使用しないでください。 (例: 1226.00 USD、金額 122600 を入力)

キャプチャ

キャプチャのトランザクションのテンプレートは以下の通りです。

フィールド名Type説明
batch_idヘッダーユーザーによって割り当てられた一意の識別子。 これは、バッチごとに繰り返すことはできません。 (数値)
transaction_typeヘッダーキャプチャテンプレートの場合、この値は capture
transaction_idrow返金するトランザクションの一意の識別子。
currencyrowトランザクション通貨 (例: USD, MXN)。
amount_to_refundrow返金額 (合計または一部)。 小数値を必ず含めてください。 カンマまたはピリオドを使用しないでください。 (例: 1226.00 USD、金額 122600 を入力)

無効化

無効化のトランザクションのテンプレートは以下の通りです。

フィールド名Type説明
batch_idヘッダーユーザーによって割り当てられた一意の識別子。 これは、バッチごとに繰り返すことはできません。 (数値)
transaction_typeヘッダー無効化テンプレートの場合、この値は void
transaction_idrow返金するトランザクションの一意の識別子。

2. ファイルをアップロード#

DEUNA Adminに、入力されたCSVファイルをアップロードします。

  1. [Go to] バッチ処理.
  2. クリック バッチのアップロード
  3. ファイルアップロードの名前を割り当てます。
  4. CSVファイルをアップロード
  5. クリック 検証.

3. バッチの結果を確認#

ファイルの状態は以下の通りです。

Estado説明必要なアクション
検証ファイルがアップロードされ、検証中です。Wait.
修正のためにファイルには手動での修正が必要なエラーが含まれています。エラーを修正し、ファイルを再アップロードしてください。
拒否ファイルは検証に失敗しました。示されたエラーを確認し、修正してファイルを再アップロードしてください。
処理中ファイルは検証に成功し、処理中です。処理の完了をお待ちください。
完了ファイル処理が完了しました。レスポンスファイル内の結果を確認してください。

ファイルのエラー

エラーの詳細を含むファイル(ファイルごとまたはトランザクションごと)をダウンロードしてください。

以下の表は、エラーとそのカテゴリを文書化しています。

カテゴリエラー名説明エラーコード
WrongFileFormatEmptyRow操作を実行するために必要な空のフィールドです。BT1
WrongFileArgumentsEmptyRow操作を実行するために必要な空のフィールドです。BT2
WrongFileFormatWrongRowFormat列の形式が正しくありません。BT3
WrongFileFormatMissingBatchIDHeaderBatch IDはヘッダーに含める必要があります。BT4
WrongFileFormatMissingTransactionTypeHeaderトランザクションの種類はヘッダーに含める必要があります。BT5
WrongFileFormatMissingEmptyRowファイルの2行目は空である必要があります。テンプレートをダウンロードすることをお勧めします。BT6
WrongFileFormatMissingDataRowsHeader必要なテンプレートヘッダーを含める必要があります。BT7
WrongFileFormatMissingOrderTokenHeaderTransaction IDはヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。BT8
WrongFileFormatMissingCurrencyHeaderCurrencyはヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。BT9
WrongFileFormatMissingAmountToCaptureHeaderamount_to_capture はヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。BT10
WrongFileFormatMissingAmountToRefundHeaderamount_to_refund はヘッダーに含める必要があります。テンプレートをダウンロードすることをお勧めします。BT11
WrongFileArgumentsInvalidBatchIDBatch IDは無効です。BT12
WrongFileArgumentsInvalidTransactionType入力されたトランザクションタイプが無効です。BT13
WrongFileFormatInvalidOrderToken入力されたトランザクションIDが無効です。BT14
WrongFileFormatInvalidCurrency入力された通貨が無効です。BT15
WrongFileFormatInvalidAmount入力された金額が無効です。BT16
WrongFileFormatCurrencyHeaderShouldBeEmptyVoidテンプレートファイルにはヘッダーに通貨を含めることはできません。テンプレートをダウンロードすることをお勧めします。BT17
WrongFileFormatCurrencyShouldBeEmptyVoidテンプレートファイルにはヘッダーに通貨値を含めることはできません。テンプレートをダウンロードすることをお勧めします。BT18
WrongFileFormatAmountHeaderShouldBeEmptyVoidテンプレートファイルにはヘッダーに金額を含めることはできません。テンプレートをダウンロードすることをお勧めします。BT19
WrongFileFormatAmountShouldBeEmpty空のテンプレートファイルには金額の値をヘッダーに含めるべきではありません。テンプレートのダウンロードをお勧めします。BT20