Z.comPayment｜FAQ｜GMOペイメントゲートウェイ

Z.com Paymentテスト環境から、本番環境へ移行する際に必要な手順を教えて下さい。

テスト環境接続先のURLを、本番環境に切り替えていただく必要がございます。
また、プログラム内にテスト環境の契約コードが設定されている箇所は、本番環境の契約コードに変えていただきます。
本番環境の管理画面設定からリダイレクト先などの情報も設定いただく必要がございます。

Z.com Paymentでカード情報の登録だけを行うとき、少額決済してキャンセルすれば、お客様のカードに履歴は残らないでしょうか？

お客様が利用されているクレジットカードによります。
デビットカードの場合はオーソリのタイミングで決済金額が引き落とされますし、発行銀行によってはお客様へオーソリ処理時にメールが送信されます。
したがって履歴を何と見るかにもよりますが履歴が残る場合はございます。

商品を購入せず、カード情報の登録のみを行った場合も、登録のタイミングでオーソリ処理は行われますでしょうか。

会員IDを利用される場合、カード情報の登録・変更のみの機能はなく、初回登録ではカードが有効化のチェックが必要ですので、オーソリ処理が行われます。
そのため、後で実売処理をするか、オーソリのキャンセルが必要となります。
初回から本当に課金したい金額で決済完了させるか、少額を決済してキャンセルするかのいずれかの方法を検討下さい。
（金額の指定無し、またはではオーソリできません。）

すでにカード登録されているユーザーIDでpeocess_code：2（会員ID決済機能）を使用して決済した場合、カード情報を指定すると指定したカード情報で決済され保存されるのでしょうか？それとも登録済みのカードで決済され、指定したカード情報は無視されるのでしょうか？

Process code 2を指定し、既存の会員IDが登録してあるにもかかわらずカード情報を付与し決済を行いますとエラーが発生いたします。
API仕様書に初回と2回目以降の会員ID決済のパラメータが記載されていますのでご確認お願いいたします。
登録されている会員IDに対して別のカード番号を登録する場合はあくまでもprocess_code=3　の利用が必要となります。

1枚のカードを複数の会員IDアカウントへ紐付けることは可能でしょうか？

可能です。
例：親のカード番号を親、子供両方の会員アカウントに紐付ける

1つの会員ID番号に複数のカードを紐付けることは可能でしょうか？

1つの会員ID番号に対して、カードは１枚のみとなっております。

CGI仕様書2-9に書いてある決済確認はなぜ行う必要があるのでしょうか？　行わなくても良いのでしょうか？

CGI方式の場合は決済確認APIを呼び出してから貴社サービス上でステータスを更新していただくほうが安全な利用が可能となります。
理由としましては、現状弊社からユーザー経由のリダイレクトの結果で決済完了を実施されていると思いますが、悪意あるユーザーが決済完了のパラメータを作成して決済を実施せずに貴社にリダイレクトした場合、実際には決済が完了していないにも関わらず貴社サービスでは決済されているように処理されてしまう可能性があるためです。
そのため、リダイレクトで決済の結果を取得している場合には、サーバ間通信である決済確認CGIで再度ステータスを確認していただいてから決済完了としていただいたほうが安全なご利用が可能となります。

APIでカード決済を行った場合も決済完了通知は通知されるのでしょうか？（管理画面のDestination URL(Settlement Completed Notification)に設定したURL）

通知されます。

非同期決済完了通知（Destination URL(Settlement Completed Notification) 決済完了通知先URLのテストについては、どのようにテストするのでしょうか。

決済完了通知先URLのテストにつきましては、テスト環境では自動では提供していませんので本番環境にてテストして頂けますようお願いします。

テスト環境にて、クレジットカードでキャンセル処理の確認をしようとすると下記のエラーが発生します。検証環境で利用できるのはクレジットカードの決済部分のみなのでしょうか LO00500009：There was an error in the query result of the settlement

テスト環境ではクレジットカード決済の決済部分のみ利用･確認可能となります。
キャンセル処理の確認はできません。
キャンセル処理につきましては、本番環境でキャンセル処理のご確認をお願いできれば幸いでございます。

テスト環境にて接続開発を行っています。クレジットカード以外の決済を選択して先に進むと、下記のエラーが出る理由を教えてください「An error has occurred in the settlement result inquiry」

タイのみ
クレジットカード以外の決済につきましては、テスト環境では、各決済センターとの接続を行なっておりません。そのため、ご指摘頂いた文言が表示され、それ以降の画面に進むことが出来ません。
お手数をお掛けいたしますが、クレジットカード以外の決済につきましては、お申込み後の本番環境で、疎通テストを行っていただくようお願いいたします。
本番環境で各決済手段を選択しても、実際に店頭等で支払うまでは課金されませんので、本番環境で疎通テスト頂いても問題ございません。

エラーになるバターンもテストしたいのですが、エラーテスト用のカード番号はありますか

以下のような番号を使っていただければエラーとなります。
・半角数字以外を設定する
例)A111111111111111
・桁数相違
例)1234564789
・想定されないカード番号
例)6111111111111111
・有効期限切れのカード
有効期限を過去に遡って設定下さい。

テスト環境にてテストが可能なカード番号をおしえてください。

カード番号：4111111111111111
有効期限：22年7月
セキュリティーコード：123

各決済手段の下限・上限を教えて下さい。

通貨によって異なるため、別途仕様書をご確認下さい。

商品金額について、小数点を利用することは可能ですか？

台湾
小数点はご利用いただけません。

タイ
小数点第2位の金額までご利用いただけます。

シンガポール
小数点第2位の金額までご利用いただけます。

マレーシア
小数点第2位の金額までご利用いただけます。

pan_bankは発行カードの会社名（銀行名）を設定とありますが、こちらで何か指定する必要はありますでしょうか。

pan_bankの指定はございませんので、任意の銀行名を入れていただいて問題ございません。

ユーザー名、商品名などパラメータを規定のサイズに収める必要があるのはなぜでしょうか？

弊社のシステム的な仕様による制限となりますが、パラメータの値が規定のサイズを超えるとエラーとなり、その後の支払手続に進めなくなります。
ユーザ名・商品名つきましては、64byte以下でカットしていただき、パラメータの送付をお願いいたします。
カット頂いても、特段問題なく決済手続を行うことはできます。

商品名に記号、スペースの制限はありますか？

制限はございません。

仕様書を見る限り、パラメータとして電話番号を送る必要がありますが、どのようなかたちで利用されますでしょうか？御社もしくは、現地決済会社から電話やショートメールを送るケースは有るでしょうか。

台湾
弊社Z.com Paymentから、電話やメールを送付することはありません。

タイ
Z.com Paymentから、電話やメールを送付することはありません。
タイの場合は決済完了後にパートナーである2C2P社より購入者へ決済完了後に確認のメールが送られます。

シンガポール
Z.com Paymentから、購入者へ電話やショートメールを送付することはありません。
現地の決済パートナーからは、決済完了後に購入者の電話番号、またはメールアドレスへ領収書をお送りします。

マレーシア
Z.com Paymentから、購入者へ電話やショートメールを送付することはありません。
現地の決済パートナーからは、決済完了後にメールアドレスへ完了通知を送ります。

決済完了通知はそれぞれいつの時点で送られるのでしょうか。

・クレジットカードの場合
決済完了とほぼ同時に通知されます。

・クレジットカード以外の決済方法の場合
台湾
購入者の入金処理と同時には反映されず、30分ほどのタイムラグがございます。

タイ・マレーシア
購入者が入金を行ったタイミングでほぼ同時に通知されます。

Z.com Paymentで、デビットカードとクレジットカードを判定する機能はあるでしょうか？

ございません。
Z.com Paymentではクレジットカードもデビットカードも同じ仕様であり、決済時のシステム処理が同じため、取引がクレジットカード決済かデビットカード決済かは判別することが出来ません。

決済ステイタスの未課金とはどのような状態でしょうか？

未課金とは、注文情報を受け付けて購入者様が入金されるまでのステイタスとなります。
未課金ステイタスの主な原因は、以下2つとなります。
①Z.com Paymentで注文を受け付けた後、購入者がエラー等でカード支払いを完了出来ない場合
②銀行振り込み・店頭支払い・コンビニ払いを決済手段として選択し、購入者の実際の支払いが完了するまでの期間

仮売上の状態から金額を変更して実売上を行うことは出来ますか？

台湾
減額変更のみ可能です。
オーソリ金額を上回る金額で実売上げの処理はできかねますので、金額変更についてはオーソリ時の金額と同額か、それを下回る金額かの設定お願いいたします。
詳細についてはZ.com Payment管理画面手順書『減額実売上』をご確認下さい。
また、オーソリ金額を上回る分の金額追加請求については、弊社の会員ID決済機能を使用し追加請求分の新たなオーダー番号とオーソリを掛けて頂ければ、ユーザー側での再度クレジットカード情報入力必要なく、決済処理を行うことが可能です。
会員ID決済仕様書とフローイメージはお客様管理画面よりAPI利用マニュアルをダウンロードいただき、該当箇所をご覧ください。

タイ
減額変更のみ可能です。
オーソリ金額を上回る金額で実売上げの処理はできかねますので、金額変更についてはオーソリ時の金額と同額か、それを下回る金額かの設定お願いいたします。
詳細についてはZ.com Payment管理画面手順書『減額実売上』をご確認下さい。

シンガポール・マレーシア
オーソリ時の金額から変更は出来ません。

決済ステータスの仮売上（Authorized）と実売上（Settlement）の違いはなんですか？

仮売上（Authorized）：
与信は取得しているが実際の売上は確定していない取引です。
管理画面もしくはAPIで対象の取引について売上処理することにより売上確定(Settlement)されます。
実売上（Settlement）：
売上が確定しており、貴社に入金される状態になっている取引です。

与信と売上の確定は一度に行われるでしょうか？また選択は可能でしょうか？

台湾・タイ・シンガポール
与信+売上を同時に処理する方法（即時売上）
別々で処理する方法（仮実売上）が選択可能です。

マレーシア
与信+売上を同時に処理いたします。（1つの処理で売上確定まで実施）

システムに接続するためのサンプルコードはありますか？

テスト環境の管理画面にて　Support→Download Filesからサンプルコートをダウンロードできます。
Perlのみの提供となります。

仕様書が２種類ありますが、APIマニュアルとCGIマニュアルどちらも確認する必要がありますか？

API の仕様書では、接続に必要な部分のみ記載しております。
各国ごとの決済方法や利用できる通貨、言語等についてはCGI 接続仕様書に集約しておりますので必要に応じて両方ご確認下さい。

Z.com Paymentの仕様書はどこから確認できますか？

Z.com Paymentのテスト環境にてアカウントを発行頂き、その管理画面の「サポート」からダウンロードが可能です。
テスト環境のお申込みは下記サイトより可能です。
https://test.global-payment.asia/client/application_form.cgi?lang_id=ja

決済環境へ接続可能な言語を教えてください。

PHP、Perl、Ruby、JAVA等のhttpsプロトコルでの通信が可能である言語であれば接続に問題ございません。