Payment method properties

Property	Details
Markets (consumer)	`TH`
Consumer currencies	`HKD`,`USD`,`CNY`,`THB`
Authentication methods	`REDIRECT`
Authentication timeout	10 mins
Minimum payment amount	Subject to channel rules
Maximum payment amount	Subject to channel rules
Payment instrument	`DIGITAL_WALLET`
Recurring payments	Yes (Currently in testing and not yet available in Production)
Separate captures	No
Refund	Full - Partial - Multiple
Refund validity	365 Days
Disputes	No

Payment Flow

Customer selects TrueMoney at checkout.

Customer is redirected to the TrueMoney payment flow to complete payment authorization.

After payment is completed, the customer is returned to the merchant site.

The merchant receives the payment result from UseePay.

Notes

TrueMoney is available for customers in Thailand.

The billing address country must be set to Thailand (TH).

TrueMoney transactions are processed in THB.

Integration Guide

api

You should set billing.country = TH when creating the paymentIntent.

request

response

{
    "id": "1012608162326154014",
    "code": "0000",
    "message": "Approved or completed successfully",
    "amount": 1,
    "currency": "THB",
    "status": "requires_customer_action",
    "description": "T-shirt",
    "confirm": true,
    "orderType": "sale",
    "mode": "payment",
    "sale": true,
    "merchant_no": "500000000007381",
    "app_id": "www.pay.com",
    "create_at": "2026-08-16T15:26:01Z",
    "modify_at": "2026-08-16T15:26:01Z",
    "merchant_order_id": "Pjpo5cKNgR3TvcYmKCaMr",
    "refunded_amount": 0,
    "next_action": {
        "type": "redirect",
        "redirect": {
            "method": "GET",
            "url": null,
            "content_type": null,
            "app_url": "https://psp.ac.truemoney.com/page/simulation-wallet/acwallet/alipayconnectcode.html?code=281666040097QW0J8YeXj8YNYs0cyhH0dGLV&pspName=TRUEMONEY&loadMode=2",
            "package_name": "com.iap.linker_portal"
        }
    },
    "return_url": "https://www.yourstore.com",
    "client_secret": "7397b3312dc48e23589988f1bfb6dea1",
    "auto_capture": true,
    "order_id": "1012608162326154014",
    "latest_payment_attempt": "pa_13MKOH7E87400",
    "payment_attempt": {
        "id": "pa_13MKOH7E87400",
        "billing": {
            "address": {
                "country": "TH",
                "city": null,
                "postcode": null,
                "state": null,
                "line1": null,
                "line2": null
            },
            "email": null,
            "name": null,
            "phone": null,
            "date_of_birth": null,
            "first_name": null,
            "last_name": null
        },
        "merchant_no": "500000000007381",
        "app_id": "www.pay.com",
        "create_at": "2026-08-16T15:26:01Z",
        "modify_at": "2026-08-16T15:26:02Z",
        "api_version": null,
        "payment_intent_id": "1012608162326154014",
        "checkout_session_id": null,
        "merchant_order_id": "Pjpo5cKNgR3TvcYmKCaMr",
        "order_id": "1012608162326154014",
        "invoice_id": null,
        "subscription_id": null,
        "customer_id": null,
        "mandate_id": null,
        "payment_method_id": null,
        "payment_method_details": {
            "type": "truemoney"
        },
        "return_url": "https://www.yourstore.com"
    },
    "setup_future_usage": false
}

TrueMoney Payment Method Options

Use payment_method_options.truemoney to specify the client environment when initiating a TrueMoney payment.

Parameters

Parameter	Type	Required	Values	Default	Description
`client`	string	No	`web`, `wap`, `app`, `mini_app`	`web`	The client platform type used to initiate the TrueMoney payment.
`os_type`	string	Conditional	`ios`, `android`	-	The operating system of the shopper's device. Required when `client` is `wap` or `app`; not required for other client types.

Client

The client parameter specifies the environment where the shopper initiates the payment.

Value	Description
`web`	Payment is initiated from a PC browser. This is the default value.
`wap`	Payment is initiated from a mobile browser.
`app`	Payment is initiated from a mobile application.
`mini_app`	Payment is initiated from a mini program.

OS Type

The os_type parameter specifies the operating system of the shopper's device.

This parameter is required only when client is wap or app.

Value	Description
`ios`	The shopper is using an iOS device.
`android`	The shopper is using an Android device.

Client Scenarios

Set client and os_type according to the environment where the payment is initiated.

Payment Scenario	`client`	`os_type`
PC Web	`web`	Not required
Mobile Web - iOS	`wap`	`ios`
Mobile Web - Android	`wap`	`android`
Mobile App - iOS	`app`	`ios`
Mobile App - Android	`app`	`android`
Mini App	`mini_app`	Not required

Note: When client is wap or app, os_type must be provided so that the appropriate payment redirection can be returned.

Request Examples

PC Web

For payments initiated from a PC browser, set client to web.

{
  "payment_method_options": {
    "truemoney": {
      "client": "web"
    }
  }
}

Since web is the default value, client can also be omitted:

{
  "payment_method_options": {
    "truemoney": {}
  }
}

Mobile Web - iOS

For payments initiated from a mobile browser on an iOS device:

{
  "payment_method_options": {
    "truemoney": {
      "client": "wap",
      "os_type": "ios"
    }
  }
}

Mobile Web - Android

For payments initiated from a mobile browser on an Android device:

{
  "payment_method_options": {
    "truemoney": {
      "client": "wap",
      "os_type": "android"
    }
  }
}

Mobile App - iOS

For payments initiated from an iOS application:

{
  "payment_method_options": {
    "truemoney": {
      "client": "app",
      "os_type": "ios"
    }
  }
}

Mobile App - Android

For payments initiated from an Android application:

{
  "payment_method_options": {
    "truemoney": {
      "client": "app",
      "os_type": "android"
    }
  }
}

Mini App

For payments initiated from a mini program:

{
  "payment_method_options": {
    "truemoney": {
      "client": "mini_app"
    }
  }
}

Important Notes

client defaults to web if it is not provided.

os_type is required when client is wap or app.

os_type is not required when client is web or mini_app.

For mobile App payment scenarios, make sure the client and os_type values match the shopper's actual client environment.

TrueMoney

Payment method properties#

Payment Flow#

Notes#

Integration Guide#

api#

request#

response#

TrueMoney Payment Method Options#

Parameters#

Client#

OS Type#

Client Scenarios#

Request Examples#

PC Web#

Mobile Web - iOS#

Mobile Web - Android#

Mobile App - iOS#

Mobile App - Android#

Mini App#

Important Notes#