Charge APIのエラー仕様についてもっと詳しい情報はありませんか

[curioshiki]

PHP独自コードよりCharge APIを使用しています。

カード決済のエラーの際、Errorオブジェクトが返りますが、

https://github.com/square/connect-php-sdk/blob/master/docs/Model/ChargeResponse.md

https://github.com/square/connect-php-sdk/blob/master/docs/Model/Error.md

エラーの内容を分別して、日本語のメッセージを返したいと考えています。

私の調べ方が足りないのかもわかりませんが、Errorオブジェクトの詳細は

https://github.com/square/connect-php-sdk/blob/master/docs/Model/ErrorCategory.md

https://github.com/square/connect-php-sdk/blob/master/docs/Model/ErrorCode.md

この2点ではないかと思います。

質問1

なにがどのエラーに該当するのか、正直よくわかりません。

カードの有効性、残高不足、セキュリティコード

などなど、システムエラー以外のお客様のアクションが必要なエラーについて、どれが何に該当し、正確にはどういうエラーなのか、資料はどこかにありますでしょうか。

もしくは、Error->detail で、デバッグ用のエラー説明が取得できるようですが、デバッグ目的で特定のエラーを発生させる方法はありますでしょうか。

質問2

Error->Codeのうち、

VERIFY_CVV_FAILUREは、セキュリティコード誤りを指すのではないかと思います。

最近話題となりました、「セキュリティコードの試行回数」が気になっておりまして、

試行回数を制限するには、当方でこのVERIFY_CVV_FAILUREをトラップしてコーディングするしかないのでしょうか?

(その場合は、当方にはTender->card_details->Card->last_4 しか分かりませんので、この情報で制限をかけるほかないかとは思いますが)

それとも、Square API側で、同一カード番号に対する試行回数を制限していただいていますでしょうか?

以上よろしくお願いいたします。

[SQ大竹-Otake · Accepted solution]

@curioshiki さん、ご質問ありがとうございます。

Square APIのエラーに関しては、下記ドキュメントでご確認いただけます。

https://developer.squareup.com/docs/api/connect/v2/?q=errorcategory#type-errorcategory

ご参照ください。