チャージバック発生時の反証を自動化したいです。

概要

チャージバックが発生した場合、事業者はチャージバックの詳細を取得するためにセラーセントラル UI を⼿動で操作する必要があります。しかし、以下IPNとDispute APIをご利用いただくことで、チャージバック発生時における反証業務の自動化を目指すことがでできます。

インテグレーションガイド

https://developer.amazon.com/ja/docs/amazon-pay-checkout/manage-disputes.html

インテグレーションイメージ

IPNでチャージバック発生を検知
※現在、Sandbox環境向けにチャージバックシュミレートを発生させるには、Amazon側にChargeIdをご連携いただき、トリガーする形となります。テスト用のChargeIdを貴社開発に必要数（10個推奨）作成いただき、担当Amazonアカウントマネジャーなどにご連絡ください。またそのタイミングでIPNは送信されませんので、以下記載のIPNフォーマットで連携されたDiputeId（ "ObjectId":"S03-0000000-0000000-B000000" ）でIPN通知されるという前提で、事業者側でテスト環境を構築していただき、開発を進めていただく必要がございます。
Upload File APIで証拠書類をUpload
提出していただく証拠書類はリンク先にてご確認ください。
UploadしたFile番号をつけて、Contest Dispute APIで反証を開始

IPN

チャージバックステータスが変更となる度にIPNが送信されます。IPN送信例：

買い⼿がチャージバックを申し⽴てた
チャージバックケースが事業者側で解決された
チャージバックケースが買い⼿よって解決された

サンプルIPN

{
    "Type" : "Notification", 
    "MessageId" : "b8043d28-13c9-1bc2-1883-0cc63262b8ee", 
    "TopicArn" : "arn:aws:sns:us-east-1:291180941288:A3BXB0YN3XH17HAEMGQX8TKDO54",
    "Message" : "{\"MerchantID\":\"AEMGQX8TKDO54\",\"ObjectType\":\"CHARGEBACK\",\"ObjectId\":\"S01-0000000-0000000-B000000\",\"ChargePermissionId\":\"S01-0000000-0000000\",\"NotificationType\":\"STATE_CHANGE\",\"NotificationId\":\"9b4155a0-c396-46d0-83f7-db1cd2cb1568\",\"NotificationVersion\":\"V2\"}",
    "Timestamp" : "2020-03-10T22:21:31.169Z",
    "SignatureVersion" : "1", 
    "Signature" : "utm+azIy4dxAf2JmB/YtHNYmW+vL09+wXUq4oiLIIKfgQY1/wvNzT5Nq3ezF1+/EjVc+1RTe0axXgyhTn3vUO93q9nmZXm+LjojbGilcSg0Ey40P5XEaOTYhVWzq12ffR5cUqG2PN0uLFN2WQuNIFCko3uPf1N74mnQNj27FWVUt/NjNwZ6kigJBmzio/Vv25B6RGXp71fXPunT5CeoGkcQyhlUn3l0Y65jME0OjNaQhAG05t1F8D8h1vY9ouRjiTuUCdiprv6udnb1P3WyK4JtdAJ3OtORkKK73gklSKzC2rQL7y1VDOE2C4wJZcVxj57EcQFFkb4wAfzsUeZ+Sfg==",
    "SigningCertURL" : "https://sns.us-east-1.amazonaws.com/SimpleNotificationService-a86cb10b4e1f29c941702d737128f7b6.pem",
    "UnsubscribeURL" : "https://sns.us-east-1.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-1:291180941288:A3BXB0YN3XH17HAEMGQX8TKDO54:9bea22b9-d89f-452c-bf36-4d6d20e12df4"
}

以下インテグレーションガイド記載のIPN仕様についてもご参照ください。
https://developer.amazon.com/docs/amazon-pay-checkout/set-up-instant-payment-notifications.html#chargeback

API仕様

インテグレーションガイド APIリファレンスをご参照ください。
https://developer.amazon.com/ja/docs/amazon-pay-api-v2/dispute.html