TrueMoney via Checkout.com

Accept TrueMoney payments from customers in Thailand with Checkout.com as the payment service provider (PSP). The customer selects TrueMoney, confirms the payment in TrueMoney, and returns to your site.

Supported workflows

Before you begin

Complete these steps before you send your first TrueMoney payment through Checkout.com:

Set up a Checkout.com integration in your workspace. Follow the Checkout.com integration setup guide if you don’t have one yet.
Ask Checkout.com to enable Alipay+ and TrueMoney on your Checkout.com processing channel.
In the Payrails Portal, go to Settings → Integrations, open your Checkout.com integration, select TrueMoney under Payment methods, and save.
Add TrueMoney as a payment option in your workflow.

Request fields for Checkout.com

Send these fields in the authorize request, in addition to the standard authorize fields. Payrails checks Required fields and returns an error when one is missing. Fields required by the PSP pass the Payrails checks but the PSP can decline the payment without them.

Field	Status	Description
`meta.order.lines`	Required	At least one line item. Each line needs `id`, `name`, `unitPrice` and a `quantity` of one or more. Sent to Checkout.com as the order items.
`meta.clientContext.osType`	Required	`ios` or `android`. Payrails rejects TrueMoney requests to Checkout.com without one. Sent to Checkout.com as the customer’s operating system.
`amount`	Required by Checkout.com	Must be in `THB`.
`meta.order.description`	Optional	Sent to Checkout.com as the payment description.
`meta.clientContext.clientType`	Optional	`app` or `wap` sets the TrueMoney terminal type. Any other value, or no value, sends `web`.
`meta.customer.name`, `meta.customer.lastName`	Optional	Sent to Checkout.com as the customer name.
`meta.customer.email`	Optional	Sent to Checkout.com as the customer email.
`meta.customer.country.code`	Optional	Sent to Checkout.com as the customer country.

Authorize a TrueMoney payment

Call authorize a payment with trueMoney as the paymentMethodCode. The response includes the redirect to TrueMoney.

Authorize request

{
  "amount": {
    "value": "500.00",
    "currency": "THB"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "trueMoney",
      "amount": {
        "value": "500.00",
        "currency": "THB"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Somchai",
      "lastName": "Jaidee",
      "email": "somchai.jaidee@example.com"
    },
    "order": {
      "description": "Order 1234",
      "lines": [
        {
          "id": "item-1",
          "name": "Phone case",
          "quantity": 1,
          "unitPrice": {
            "value": "500.00",
            "currency": "THB"
          }
        }
      ]
    },
    "clientContext": {
      "clientType": "app",
      "osType": "android"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

After the customer confirms the payment, TrueMoney returns them to your success or error URL. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Checkout.com handles TrueMoney

Checkout.com processes TrueMoney through the Alipay+ network. Payrails creates a payment setup at Checkout.com and confirms it for TrueMoney. The confirmation returns the redirect to TrueMoney.
TrueMoney through Checkout.com is an app-based wallet payment, so every request needs the customer’s mobile operating system in meta.clientContext.osType.
Payrails sends only order lines of type lineItem, or lines with no type. It skips tax, discount and shipping lines, and lines with no unit price or a zero quantity.
If Checkout.com reports that TrueMoney isn’t ready on your processing channel, the payment fails before Payrails redirects the customer.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

TrueMoney via Checkout.com

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a TrueMoney payment

How Checkout.com handles TrueMoney

​Supported workflows

​Before you begin

​Request fields for Checkout.com

​Authorize a TrueMoney payment

​How Checkout.com handles TrueMoney

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a TrueMoney payment

How Checkout.com handles TrueMoney