FAQ

About system / specifications

• Z.com PaymentWhat steps do I need to take to move from a test environment to a production environment?

  It is necessary to switch the URL of the test environment connection destination to the production environment.
  In addition, the part where the contract code of the test environment is set in the program should be changed to the contract code of the production environment.
  It is also necessary to set information such as the redirect destination from the management screen settings of the production environment.

• If I only register my card information with Z.com Payment, will my card not have a history if I cancel it with a small payment?

  It depends on the credit card you are using.
  In the case of a debit card, the payment amount will be deducted at the time of authorization, and depending on the issuing bank, an email will be sent to the customer at the time of authorization processing.
  Therefore, depending on how you look at the history, the history may remain.

• Even if I do not purchase a product and only register my card information, will the authorization process be processed at the time of registration?

  When using a member ID, there is no function only for registering / changing card information, and it is necessary to check the activation of the card at the first registration, so authorization processing is performed.
  Therefore, it is necessary to process the actual sale later or cancel the authorization.
  Please consider either the method of completing the payment with the amount you really want to charge from the first time, or the method of payment a small amount and canceling.
  (You cannot authorization without specifying the amount or with.)

• If I payment using peocess_code:2 (member ID payment function) with a user ID that is already registered with a card, will it be payment and saved with the specified card information when I specify the card information? Or will it be payment with a registered card and ignore the card information I provided?

  If you specify Process code 2 and give the card information and make a payment even though the existing member ID is registered, an error will occur.
  Please check the API specifications for the parameters for the first and second member ID payment.
  If you want to register a different card number for the registered member ID, you need to use process_code = 3.

• Is it possible to link one card to multiple member ID accounts?

  Is possible.
  Example: Linking a parent's card number to both parent and child member accounts

• Is it possible to link multiple cards to one member ID number?

  There is only one card for each member ID number.

• Why do I need to check the payment described in CGI Specification 2-9?　Is it okay not to do it?

  In the case of the CGI method, it is safer to call the payment confirmation API and then update the status on your service.
  The reason is that we are currently completing the payment as a result of the redirect via the user, but if a malicious user creates a parameter for the payment completion and redirects to your company without performing the payment, This is because your service may process the payment as if it had been settled even though the payment has not actually been completed.
  Therefore, if you have obtained the payment result by redirect, it is safer to use it after confirming the status again with the payment confirmation CGI, which is a communication between servers, and then completing the payment.

• If I payment a card with the API, will I still be notified of the payment completion notification? (URL set in Destination URL (Settlement Completed Notification) on the management screen)

  You will be notified.

• Asynchronous payment Destination URL (Settlement Completed Notification) payment How do you test the completion notification URL?

  The test of the payment completion notification URL is not automatically provided in the test environment, so please test it in the production environment.

• In the test environment, when I try to confirm the cancellation process with a credit card, the following error occurs. payment LO00500009:There was an error in the query result of the settlement

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

• We are developing connections in a test environment. If I select a non-credit card payment and proceed, why do I get the error below? "An error has occurred in the settlement result inquiry"

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

• I would also like to test Bataan for error, is there a card number for error testing?

  If you use a number like the one below, an error will occur.
  ・ Set other than half-width numbers
  Example) A111111111111111
  ・ Difference in the number of digits
  Example) 1234564789
  ・ Unexpected card number
  Example) 61111111111111111
  ・ Expired card
  Please set the expiration date retroactively.

• Please provide a card number that can be tested in a test environment.

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

• What are the lower and upper limits of each payment method?

  Please check the specifications separately as it depends on the currency.

• Is it possible to use a decimal point for the product amount?

  Taiwan
  Decimal points are not allowed.

  Thailand
  You can use up to two decimal places.

  Singapore
  You can use up to two decimal places.

  Malaysia
  You can use up to two decimal places.

• pan_bank says to set the company name (bank name) of the issuing card, but do I need to specify anything here?

  Since pan_bank is not specified, there is no problem if you enter any bank name.

• Why do you need to keep parameters such as username, product name, etc. within a specified size?

  Although it is limited by our system specifications, if the parameter value exceeds the specified size, an error will occur and you will not be able to proceed to the subsequent payment procedure.
  Please cut the user name and product name to 64 bytes or less and send the parameters.
  Even if you cut it, you can still carry out the payment procedure without any problems.

• Are there any symbols or space restrictions in the product name?

  There are no restrictions.

• As far as the specification is concerned, it is necessary to send a phone number as a parameter, but in what form will it be used? Do you or a local payment company send you a phone call or text message?

  Taiwan
  We will not send you Z.com phone or email from Payment.

  Thailand
  Z.com Payment will not call or send you emails.
  In the case of Thailand, after the completion of payment, the buyer will receive a confirmation email from our partner 2C2P after the completion of payment.

  Singapore
  Z.com Payment will not call or text the buyer.
  The local payment partner will send a receipt to the buyer's phone number or email address after completing the payment.

  Malaysia
  Z.com Payment will not call or text the buyer.
  The local payment partner will send a completion notification to your email address after the payment is completed.

• payment When will I receive a completion notification?

  ・ In the case of a credit card
  payment You will be notified almost as soon as it is completed.

  ・ In the case of payment methods other than credit cards
  Taiwan
  It will not be reflected at the same time as the purchaser's payment process, and there will be a time lag of about 30 minutes.

  Thailand & Malaysia
  You will be notified almost at the same time as when the buyer makes a deposit.

• Is there a function to determine between debit and credit cards in Z.com Payment?

  There is no such thing.
  With Z.com Payment, both credit and debit cards have the same specifications, and the system processing at the time of payment is the same, so it is not possible to determine whether the transaction is a Credit card payment or a debit card payment.

• payment What does it mean to be uncharged for status?

  Uncharged is the status from receiving the order information to the purchaser's payment.
  There are two main causes of unpaid status:
  ① After accepting an order with Z.com Payment, if the purchaser cannot complete the card payment to an error etc.
  (2) The period until the actual payment of the purchaser is completed by selecting bank transfer, over-the-counter payment, or convenience store payment as the payment method.

• Is it possible to change the amount from the authorization state and do actual sales?

  Taiwan
  Only reductions are possible.
  authorization Since it is not possible to process actual sales amount with an amount that exceeds the amount, please set the amount change to the same amount as the amount at the time of authorization or less than it.
  For details Z.com please refer to the "Reduction actual sales" procedure manual on the payment management screen.
  In addition, if you are charged an additional amount that exceeds the authorization amount, you can use our member ID payment function and multiply the new order number and authorization for the additional charge, and you can perform payment processing without the need to enter your credit card information again.
  Member ID payment For specifications and flow images, please download the API usage manual from the customer management screen and refer to the relevant section.

  Thailand
  Only reductions are possible.
  authorization Since it is not possible to process actual sales amount with an amount that exceeds the amount, please set the amount change to the same amount as the amount at the time of authorization or less than it.
  For details Z.com please refer to the "Reduction actual sales" procedure manual on the payment management screen.

  Singapore & Malaysia
  authorization It is not possible to change the amount at the time.

• What is the difference between authorization (Authorized) and actual sales (Settlement) payment status?

  Authorized: Authorized:
  It is a transaction that has acquired credit but has not confirmed actual sales.
  Sales are settlement by processing sales for the target transaction on the management screen or API.
  Actual sales (Settlement):
  It is a transaction whose sales have been confirmed and are ready to be credited to your company.

• Will credit and sales be finalized at the same time? Is it possible to choose?

  Taiwan, Thailand, Singapore
  How to Process Credit + Sales at the Same Time (capture)
  You can choose to process them separately (tentative actual sales).

  Malaysia
  We process credit + sales at the same time. (Implementation until sales are finalized in one process)

• Is there a Mr./Ms. cord to connect to the system?

  You can download the sample coat from Support → Download Files on the management screen of the test environment.
  Only provided in Perl.

• There are two types of specifications, do I need to check both the API manual and the CGI manual?

  The API specifications describe only the parts required for connection.
  The payment methods, available currencies, languages, etc. for each country are summarized in the CGI connection specifications, so please check both if necessary.

• Where can I find the specifications for Z.com Payment?

  You can create an account in the Z.com Payment test environment and download it from "Support" on the management screen.
  You can apply for a test environment from the following site.
  https://test.global-payment.asia/client/application_form.cgi?lang_id=ja

• payment What languages can I connect to the environment?

  There is no problem with connection as long as it is a language that can communicate with https protocols such as PHP, Perl, Ruby, and JAVA.