Apex 開発者ガイド
j支払承認取消サービス API
顧客は支払承認を実行しますが、後で承認のすべてまたは一部をキャンセルする必要がある場合があります。たとえば、顧客が 3 つの品目を購入し、その後、最初の品目がすでに在庫にあることに気付いたとします。商取引の支払 API では、未決の支払承認のすべてまたは一部を取り消すことができます。
顧客支払ゲートウェイで支払が承認された後、商取引の支払によって承認に関する情報を保存するための支払承認レコードが作成されます。ユーザまたはプロセスが承認に対して取消を行うと、承認取消サービスによって情報を保存するための支払承認調整が作成されます。調整は承認に関連しています。
承認取消サービスをコールするには、次のエンドポイントに POST 要求を実行します。
エンドポイント
このサービスは 1 つのコールに 1 つの承認取消要求を受け入れます。許可されている支払承認調整 API パラメータは次のとおりです。
| パラメータ | 必須 | 説明 |
|---|---|---|
| amount | 必須 |
承認から取り消される金額。0 以下は指定できません。 Salesforce では、PaymentAuthorizationAdjustment.Amount と PaymentAuthorization.Amount を比較する検証は行っていません。 支払ゲートウェイが承認額を上回る取消額を許可している場合、承認の結果残高が負の値になる可能性があります。ゲートウェイが 0 を下回る承認残高をサポートしている場合にゲートウェイコールを回避するには、アダプタが承認の金額、残高、および合計取消額を照会するように設定して、残高が 0 を下回っていてもエンドポイントをコールしないようにします。 |
| accountId | 省略可能 | この承認取消がリンクされている取引先 ID。 |
| effectiveDate | 省略可能 | 取消が承認に適用される日付。 |
| 省略可能 | 不正パラメータ | |
| ipAddress | 省略可能 | 不正パラメータ |
| macAddress | 省略可能 | 不正パラメータ |
| phone | 省略可能 | 不正パラメータ |
| comments | 省略可能 | 承認取消に関するユーザによるコメント。1,000 文字未満である必要があります。 |
要求と応答のサンプル
この要求は、承認に対して 150 ドルの取消をコールします。
サンプル応答 - 成功
承認取消応答が成功すると、ゲートウェイの応答と支払承認調整エンティティを作成するための値に関する情報が提供されます。
Salesforce での支払承認調整の結果はこのようになります。
エラーが返された場合、応答にはゲートウェイのエラーコードとエラーメッセージが表示されます。
サンプル応答 - エラー