APIのテストを行う際にはクレジットカード番号が必要です。自分のカードでテストしてしまったら課金されてしまうので大変です。
そこで使いたいのがテスト用のカード番号になります。Squareでは以下の番号を用意しています。
Square Connect API Documentationより。
| ブランド | カード番号 |
|---|---|
| Visa | 4532-7597-3454-5858 |
| MasterCard | 5409-8899-4417-9029 |
| Discover | 6011-0336-2137-9697 |
| Diners Club | 3600-4244-8464-08 |
| JCB | 3566-0057-3488-0650 |
| American Express | 3712-6346-2726-550 |
| China UnionPay | 6222-5201-1913-8184 |
CVV（セキュリティコード）、有効期限、郵便番号は任意で指定できます。ただし、以下の条件によってわざとエラーを起こせます。
- CVVに911を指定するとCard CVV incorrectエラーになります。
- 郵便番号に99999を指定するとCard postal code incorrectエラーになります。
- 有効期限を 01/40 （月年の順）に指定するとCard expiration date incorrectエラーになります。
- 決済金額を403にするとCard declinedエラーになります。
さらに card_nonce と customer_card_id を下記の辺りに指定することで、それぞれエラーを起こせます。
| card_nonce | customer_card_id | エラー |
|---|---|---|
| fake-card-nonce-ok | fake-customer-card-id-ok | 処理成功します |
| fake-card-nonce-rejected-cvv | fake-customer-card-id-rejected-cvv | Card CVV incorrect |
| fake-card-nonce-rejected-postalcode | fake-customer-card-id-rejected-postalcode | Card postal code incorrect |
| fake-card-nonce-rejected-expiration | fake-customer-card-id-rejected-expiration | Card expiration date incorrect |
| fake-card-nonce-declined | fake-customer-card-id-declined | Card declined |
| fake-card-nonce-already-used | 指定なし | Card nonce already used |
これらはサンドボックス環境で使える特別な条件になりますので注意してください。テスト時に使って適切なエラー処理の実装に役立ててください。