Skip to main content

GMO Payment Gateway


GMO Payment Gateway

This article describes how to configure the GMO payment gateway in Zuora.

Supported Payment Types

The GMO payment gateway supports the following payment types:

  • Credit Card
  • CC Reference Transaction

Each payment type supports the following cards:

  • Visa
  • MasterCard
  • AmericanExpress
  • Diners Club
  • JCB

Supported Payment Operations

The GMO payment gateway supports the following operations for the Credit Card payment type:

  • Payment method creation:
    • Authorization
    • Authorization Void
  • Payment 
  • Payment Void
  • Payment Refund

The GMO payment gateway supports the following operations for the CC Reference Transaction payment type:

  • Payment method creation: 
    • Existing Member ID — Check if the Member ID exists and whether it has a registered card
    • New Member ID — Generate a new Member ID and then register the raw card details
  • Payment 
  • Payment Void
  • Payment Refund

Configure the GMO Payment Gateway

  1. Navigate to Z-Payments Settings > Setup Payment Gateway
  2. Select GMO Payment Gateway from the Gateway Type drop-down menu.
  3. Click create gateway. The following screen is displayed.
  4. Enter the configuration information. See Common Configuration Fields for more information.
  5. Click save gateway information.

Common Configuration Fields

Basic Information

  • Name: The name of this payment gateway in Zuora.
  • Use Gateway Test Environment: Determines whether transactions are sent to the test environment or live environment of the GMO payment gateway.


  • Shop ID: The ID used to identify the merchant. Issued by the GMO payment gateway.
  • Shop password: The password of the Shop ID.
  • Site ID: The ID that identifies the sites. Issued by the GMO payment gateway.
  • Site password: The password of the Site ID.


  • Cards Accepted: Check the cards you want to accept using this payment gateway.
  • Default Authorization Amount: The amount to use when performing an authorization when creating or updating a card.
  • Verify new payment method
    • Optional for Credit Card payment type. Triggers a credit card authorization during card creation.
    • Required for CC Reference Transaction payment type. Verifies if the Token exists in the GMO payment gateway database and verifies that it has a registered card or generates a new Token with a registered card.
  • Verify updated payment method: Triggers a credit card authorization when updating an existing card.
  • Recurring Indicator: Used only by the CC Reference Transaction payment type. Indicates whether the credit card being registered for a Member ID is subject to recurring payments.
  • Card Sequence Mode: Used only by the CC Reference Transaction payment type. If selected, the Card Sequence Mode is set during a credit card registration for a Member ID.

See Setting Up Payment Gateways for more information about configuration fields that are common to all payment gateways.

Credit Card Reference Transactions

Zuora supports GMO Payment Gateway tokens for Visa, MasterCard, AmericanExpress, Diners Club, and JCB.

Tokens are used for credit card reference transactions in Zuora. A reference transaction is simply a representation of a credit card payment method without having sensitive payment method information like the credit card number stored in Zuora. Please note that the token cannot be used with another gateway, which is why we recommend storing credit card information in Zuora whenever possible.

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

See the following topics for more information about setting up credit card reference transactions in Zuora.

The following SOAP API call can be used to create a payment method that represents a GMO Payment Gateway-stored credit card.

 <ns1:zObjects xsi:type="ns2:PaymentMethod">

Testing Your Configuration 

We recommend that you test your payment gateway by using both your payment gateway's test and production (live) environments.  Once you have completed testing in the gateway's test environment, it is recommended that you perform a test in your live production environment with a real credit card. If there are any differences in the configuration of your testing and production accounts, testing in production ensures your production merchant account is set up properly and can successfully connect to the production environment.

Access this page to apply for your test environment on the GMO Payment Gateway website. Please contact the GMO Support team for test credit card numbers and testing scenarios.


The GMO payment gateway does not support the following:

  • Non-referenced refunds
  • Partial refunds