支払承認取消サービス API

承認取消とは、顧客の支払方法で資金の保留を解除することにより承認を無効にするトランザクションです。承認取消サービスを使用すると、ユーザは未決の支払承認を取り消すことができます。

顧客は支払承認を実行しますが、後で承認のすべてまたは一部をキャンセルする必要がある場合があります。たとえば、顧客が 3 つの品目を購入し、その後、最初の品目がすでに在庫にあることに気付いたとします。商取引の支払 API では、未決の支払承認のすべてまたは一部を取り消すことができます。

顧客支払ゲートウェイで支払が承認された後、商取引の支払によって承認に関する情報を保存するための支払承認レコードが作成されます。ユーザまたはプロセスが承認に対して取消を行うと、承認取消サービスによって情報を保存するための支払承認調整が作成されます。調整は承認に関連しています。

承認取消サービスをコールするには、次のエンドポイントに POST 要求を実行します。

エンドポイント

このサービスは 1 つのコールに 1 つの承認取消要求を受け入れます。許可されている支払承認調整 API パラメータは次のとおりです。

表 1. 取消サービス入力パラメータ
パラメータ	必須	説明
amount	必須	承認から取り消される金額。0 以下は指定できません。 Salesforce では、`PaymentAuthorizationAdjustment.Amount` と `PaymentAuthorization.Amount` を比較する検証は行っていません。支払ゲートウェイが承認額を上回る取消額を許可している場合、承認の結果残高が負の値になる可能性があります。ゲートウェイが 0 を下回る承認残高をサポートしている場合にゲートウェイコールを回避するには、アダプタが承認の金額、残高、および合計取消額を照会するように設定して、残高が 0 を下回っていてもエンドポイントをコールしないようにします。
accountId	省略可能	この承認取消がリンクされている取引先 ID。
effectiveDate	省略可能	取消が承認に適用される日付。
email	省略可能	不正パラメータ
ipAddress	省略可能	不正パラメータ
macAddress	省略可能	不正パラメータ
phone	省略可能	不正パラメータ
comments	省略可能	承認取消に関するユーザによるコメント。1,000 文字未満である必要があります。

要求と応答のサンプル

この要求は、承認に対して 150 ドルの取消をコールします。

サンプル応答 - 成功

承認取消応答が成功すると、ゲートウェイの応答と支払承認調整エンティティを作成するための値に関する情報が提供されます。

Salesforce での支払承認調整の結果はこのようになります。

エラーが返された場合、応答にはゲートウェイのエラーコードとエラーメッセージが表示されます。

サンプル応答 - エラー