Welcome to Zuora Product Documentation

Explore our rich library of product information

Create payment methods on Planet

Create credit card payment methods on Planet Datatrans using a hosted payment page or REST API, and learn how Zuora stores Datatrans tokens for recurring payments.

This payment gateway integration can be requested through the Specialized Payment Connections service at an additional cost.

To create Credit Card payment methods on Planet Datatrans, use one of the following approaches:

  • Hosted payment page
  • REST API

Hosted payment page approach

You can implement a hosted payment page through the Payment Pages 2.0 solution to support the following payment flows:

  • Create and save a card payment method
  • Process a one-time payment without saving the payment method
  • Process the first payment and save the payment method for subsequent recurring payments

During payment method validation and creation, Datatrans returns the cardOnFile ID in processing webhook events, which Zuora stores as the Token ID. After the payment method is successfully created, the gateway returns two additional tokens that are also stored for the payment method in Zuora. These tokens will be used to process recurring transactions.

Zuora UI fieldDatatrans field
Token IDcardOnFile ID
Second Token IDMerchant Reference Number
Third Token IDGateway Transaction Reference ID

In the Electronic Payment Methods section of the customer account page, you can retrieve Second Token ID and Third Token ID.

Complete the following tasks to implement a Payment Page 2.0 to support one-time payment flows:

  1. Prepare for the integration.
  2. Set up a Payment Page 2.0.
  3. Request a signature for the Payment Page from Zuora.
  4. Set up your client code to integrate the Payment Page to your web page.
  5. Implement the callback response.