Skip to main content

Tokenized — Create Customer

Creates a tokenized payment customer. The customer binds their card once on the RM-hosted page, after which you can charge them on demand using the Create Customer Order API.

When to Use

Use this endpoint when:

  • Offering "save card for later" checkout
  • You manage your own charging schedule (one-off or ad-hoc)
  • Building a subscription with custom billing logic

How to Use

Endpoint
POST/v3/tokenized-payment

Step 1: Create the Customer

POST customer + product info. RM returns a paymentUrl for the customer to bind their card.

Step 2: Send the Customer to Bind a Card

Redirect them to paymentUrl. After binding, RM redirects back to your redirectUrl.

Step 3: Charge On Demand

Use the returned id (customer ID) with Create Customer Order to charge whenever needed.


Request Parameters

storeIdSTRINGrequired

Revenue Monster Store ID

emailSTRINGrequired

Customer email address

nameSTRINGrequired

Customer name

countryCodeSTRINGrequired

Customer country code

Example: "60"

phoneNumberSTRINGrequired

Customer phone number

productNameSTRINGrequired

Tokenized product name

productDescriptionSTRINGrequired

Tokenized product description

redirectUrlSTRINGrequired

URL to redirect the customer to after card binding

Response Parameters

itemOBJECT

Response item

idSTRING

Tokenized customer ID

merchantIdSTRING

Merchant ID

storeIdSTRING

Store ID

labelSTRING

Customer card: front six and last four digits

emailSTRING

Customer email

countryCodeSTRING

Customer country code

phoneNumberSTRING

Customer phone number

productNameSTRING

Tokenized product name

productDescriptionSTRING

Tokenized product description

isActiveBOOLEAN

Whether the token is active. Becomes true after card is bound successfully.

createdAtSTRING

Created date time

updatedAtSTRING

Last updated date time

clientKeySTRING

Internal usage only

redirectUrlSTRING

URL for customer to redirect after card binding

notifyUrlSTRING

URL for payment notifications

paymentUrlSTRING

URL for customer to bind their card

codeSTRING

"SUCCESS" if the request succeeded, otherwise an error code.

errorOBJECT

Error details

codeSTRING

Error code if the request failed.

messageSTRING

Error message if the request failed.

debugSTRING

Debug message (sandbox only).