トラブルシューティングと FAQ
このセクションでは、インテグレーションで発生する可能性がある問題に対する提案と解決策について説明します。
これは、カードを支払者に発行した金融機関によって異なります。各カード発行者は、支払者の口座で資金を確保する承認の有効期限を定義し、その間、決済請求取引が到着するのを待ちます。一般的に、5 ~ 8 処理日で、その後、支払者の口座から承認が除去され、資金へのアクセスが支払者に解放されます。
次のフィールドを使用して、検証エラーを理解できます。
フィールド error.explanation [REST][NVP] には、最小長、想定されている長さなどのエラーに関する詳細を説明する、人間が読めるエラーテキストが含まれています。このテキストの形式は保証できないため、この情報は解析しないでください。
Payment Client と Virtual Payment Client とのインテグレーションは、<<webServicesIntegration>> に対して返される列挙型とは異なるレスポンスコードを返します。以下の表に、QNB ALAHLI によって返される 2 種類のレスポンスのマッピングを示します。
Payment Client/Virtual Payment Client | <<webServicesIntegration>> | ||
---|---|---|---|
レスポンスコード | 説明 | response.gatewayCode |
説明 |
0 | 取引は正常に処理されました | APPROVED |
取引は承認されました |
1 | 取引を処理できませんでした | UNSPECIFIED_FAILURE |
取引を処理できませんでした |
2 | 取引は拒否されました - 発行元銀行にお問い合わせください | DECLINED |
リクエストされた操作が成功しませんでした。たとえば、支払いがイシュアー(カード発行会社)によって拒否されたか、支払者認証を正常に完了できませんでした。 |
3 | 取引は拒否されました - 銀行からの応答がありません | TIMED_OUT |
応答がタイムアウトしました |
4 | 取引は拒否されました - カードの有効期限が切れています | EXPIRED_CARD |
カードの有効期限が切れているため、取引は拒否されました |
5 | 取引は拒否されました - 預金が不足しています | INSUFFICIENT_FUNDS |
資金が不足しているため、取引は拒否されました |
6 | 取引は拒否されました - 銀行のシステムエラー | ACQUIRER_SYSTEM_ERROR | 取引を処理しているときにアクワイアラーのシステムエラーが発生しました |
7 | 支払サーバの処理エラー。通常は、クレジットカード番号などの無効な入力データが原因で発生します。処理エラーが発生する可能性もあります。 | SYSTEM_ERROR |
取引の処理中に内部システムエラーが発生しました |
8 | 取引は拒否されました - 取引のタイプがサポートされていません | NOT_SUPPORTED |
取引のタイプがサポートされていません |
9 | 銀行が取引を拒否しました (銀行に問い合わせないでください) | DECLINED_DO_NOT_CONTACT |
取引が拒否されました - イシュアー (カード発行会社) に問い合わせないでください |
A | 取引の中止 | ABORTED |
取引はカード所有者によって中止されました |
B | 取引はブロックされました - 次の場合に返されます。 - 検証セキュリティレベルの値が「07」の場合 - 加盟店で 3D セキュアのブロックが有効になっている場合 - 全体のリスク評価の結果で「Reject」または「System Reject」が返された場合 |
BLOCKED |
取引は、リスクまたは 3D セキュアのブロックルールが原因でブロックされました |
C | 取引キャンセル済み | CANCELLED |
取引はカード所有者によってキャンセルされました |
D | 繰延取引 | DEFERRED_TRANSACTION_RECEIVED |
繰延取引が受領され、処理を待機しています |
E | 取引は拒否されました - イシュアー (カード発行会社) に問い合わせてください | REFERRED |
取引は拒否されました - カード発行者に問い合わせてください |
F | 3D セキュア認証に失敗しました | AUTHENTICATION_FAILED |
3D セキュア認証に失敗しました |
I | カードのセキュリティコードエラー | INVALID_CSC |
カードのセキュリティコードが無効です |
L | 購買取引がロックされています。これは、同じ購買取引番号を使用して行われている別の取引があることを示します。 | LOCK_FAILURE |
注文がロックされました - この注文に対して別の取引が進行中です |
M | 取引は送信されました(取引はアクワイアラーに送信されましたが、支払サーバはその取引を完了するためにそれを受信していません) | SUBMITTED |
取引は送信されました - 応答はまだ受信されていません |
N | カード所有者が 3D セキュアに登録されていません(認証のみ) | NOT_ENROLLED_3D_SECURE |
カード所有者が 3D セキュアに登録されていません |
P | 取引は保留中です | PENDING |
取引は保留中です |
R | 再試行回数の制限を超過しました。取引は処理されません | EXCEEDED_RETRY_LIMIT |
再試行回数の制限を超過しました |
S | 取引は拒否されました - 重複するバッチ | DUPLICATE_BATCH |
取引は重複するバッチが原因で拒否されました |
T | 住所確認エラー | DECLINED_AVS |
取引は住所確認が原因で拒否されました |
U | カードのセキュリティコードエラー | DECLINED_CSC |
取引はカードのセキュリティコードが原因で拒否されました |
V | 住所確認とカードのセキュリティコードエラー | DECLINED_AVS_CSC |
取引はアドレス確認とカードのセキュリティコードが原因で拒否されました |
W | 取引は拒否されました - 支払区分がサポートされていません。 | DECLINED_PAYMENT_PLAN |
取引は支払区分が原因で拒否されました |
X | 保留中の精算が承認されました - バッチ精算システムによって承認されましたが、アクワイアラーからの詳細を待機しています。 | APPROVED_PENDING_SETTLEMENT |
取引は承認されました - 保留中のバッチ精算 |
? | 不明なレスポンス | UNKNOWN |
不明なレスポンス |
Payment Client/Virtual Payment Client | <<webServicesIntegration>> | ||
---|---|---|---|
レスポンスコード | 説明 | response.cardholderVerification.avs.gatewayCode |
説明 |
X | 完全一致 – 住所と 9 桁の郵便番号 | ADDRESS_ZIP_MATCH |
住所 (番地) と郵便番号が一致しました |
Y | 完全一致 – 住所と 5 桁の郵便番号 | ||
D | 国際取引に対して住所(番地)と郵便番号が一致しました。 | ||
M | 国際取引に対して住所(番地)と郵便番号が一致しました。 | ||
F | 住所 (番地) と郵便番号が一致しました。英国にのみ適用されます。 | ||
W | 9 桁の郵便番号が一致しました。住所は一致しませんでした | ZIP_MATCH |
郵便番号が一致しました。住所 (番地) は一致しませんでした |
P | 国際取引に対して郵便番号は一致しましたが、住所 (番地) は形式が異なるため検証されていません。 | ||
Z | 5 桁の郵便番号が一致しました。住所は一致しませんでした | ||
A | 住所のみ一致 | ADDRESS_MATCH |
住所 (番地) が一致しました |
B | 国際取引に対して住所 (番地) が一致しました。郵便番号は形式が異なるため検証されていません。 | ||
S | サービスは現在サポートされていません。 | SERVICE_NOT_SUPPORTED |
サービスは現在アクワイアラーまたは加盟店によってサポートされていません |
G | 国際取引、住所情報は利用できません。 | NOT_VERIFIED |
国際取引で AVS を検証できませんでした |
C | 国際取引に対して住所 (番地 )と郵便番号は、形式が異なるため検証されませんでした。 | ||
I | Visa のみ。国際取引で住所情報は検証されませんでした。 | ||
R | カード発行者システムを使用できません。再試行してください。 | SERVICE_NOT_AVAILABLE_RETRY |
カード発行者システムを使用できません。再試行できます |
U | 住所を使用できません。イシュアー (カード発行会社) からのデータがありません。 | NOT_AVAILABLE |
イシュアー (カード発行会社) から入手できるデータがないか、AVS データが取引に対してサポートされていません |
E | 通信販売/電話注文ではありません。 | ||
N | 住所と郵便番号が一致しませんでした | NO_MATCH |
一致しません |
0 (ゼロ) | AVS が要求されませんでした。(VisaII で使用) | NOT_REQUESTED |
AVS がリクエストされませんでした |
K | カード所有者名のみ一致しました。 | NAME_MATCH |
カード所有者名が一致しました |
O | カード所有者名および住所が一致しました | NAME_ADDRESS_MATCH |
カード所有者名および住所が一致しました |
L | カード所有者名および郵便番号が一致しました | NAME_ZIP_MATCH |
カード所有者名および郵便番号が一致しました |
Payment Client/Virtual Payment Client | <<webServicesIntegration>> | ||
---|---|---|---|
レスポンスコード | 説明 | response.cardSecurityCode.gatewayCode |
説明 |
M | 有効な CSC または CSC 一致 | MATCHED |
有効または一致 |
S | 加盟店は、カードに存在しない CSC を示しています | NOT_PRESENT |
加盟店は、カードに存在しない CSC を示しました |
P | CSC は処理されませんでした | NOT_PROCESSED |
未処理 |
U | カード発行者は、登録または認定されていません | NOT_SUPPPORTED |
イシュアー(カード発行会社)は、登録または認定されていません |
N | コードが無効または一致しません | NO_MATCH |
無効または一致しません。 |
はい。ゲートウェイではべき等操作がサポートされているため、全く同じ詳細を使用して要求を再送信できます。べき等操作では、繰り返して呼び出された場合に同じ結果になります。ゲートウェイは、既にリクエストを受信していた場合、元のレスポンスを返します。そうでない場合、リクエストを処理し、レスポンスを返します。
order.id
と transaction.id
フィールドはリクエストで指定されてレスポンスで返されるため、通常はこれらのフィールドを使用してリクエストをレスポンスに一致させることができます。ただし、アプリケーションで同期インテグレーションモデルがサポートされていない場合、またはリクエストのソースと対象が異なる場合は、correlationId
フィールドを使用して、リクエストとそれに一致するレスポンスを識別できます。correlationId
は一時的な識別子であるため、その値はゲートウェイは長く保持されず、レスポンスで指定されたようにリクエストへのレスポンスに返されます。correlationId
はすべての <<webServicesIntegration>> リクエストで使用できます。
No merchant acquirer link
エラーを受信するのはなぜですか。your payment service provider に問い合わせて、ゲートウェイで加盟店アクワイアラーリンクがカードタイプと通貨の必要な組み合わせに対して設定されるようにしてください。
Merchant Administration は、注文の閲覧と管理を加盟店が容易に行う手助けとなる Web ベースのインターフェイスです。加盟店は、注文/取引明細の検索と閲覧、CSV レポートのダウンロード、3-D Secure の結果の確認、リスクコントロールの設定、注文書の手動作成、払い戻しの管理などを行うことができます。詳細については、『Merchant Administration ユーザーガイド』を参照してください。
加盟店は、ゲートウェイにボーディングしていて、Merchant Administration に正常にアクセスできるように加盟店プロファイルが設定されている必要があります。