TrueMoney
TrueMoney is an e-wallet app covering 6 countries in the SEA region (Thailand, Cambodia, Myanmar, Indonesia, the Philippines and Vietnam). In Thailand, the platform includes TrueMoney Wallet, WeCard by MasterCard, TrueMoney Cash Card, Kiosk, Express, Payment Gateway and Remittance. By December 2020, The platform has more than 15 million active users across Thailand and growing.
Features
Processing currencies | THB,GBP |
---|---|
Settlement currencies | GBP |
Minimum transaction amount | 0.01 THB |
Maximum transaction amount | 7,000 THB |
Refunds | ✅ |
Partial Refunds | ✅ |
Multiple partial refund | ❌ |
Chargeback | ❌ |
Integration Method
Payment method enumeration values: truemoney
There is integration method for TrueMoney
- Direct API
- Checkout
Direct API
How to integration
For direct API integration, you can create a PaymentIntent and get url in only one step. The following is the demo of creating payment intent:
A PaymentIntent is an object that represents your intent to collect payment from your customer and tracks the lifecycle of the payment process. Create a PaymentIntent on your server and specify the amount to collect and a supported currency. If you have an existing Payment Intents integration, add truemoney
to the list of payment method types.
Request
{
"amount": 2000,
"currency": "THB",
"confirm": true,
"payment_method_options": {
"truemoney": {
"terminal_type": "WEB",
"os_type": "ANDROID"
}
},
"payment_method_types": ["truemoney"],
"return_url": "https://wooshpay.com"
}
Response
{
"id": "pi_1663020464626204672",
"object": "payment_intent",
"created": 1685329951000,
"currency": "THB",
"amount": 1000,
"status": "requires_action",
"livemode": false,
"quantity": 2,
"client_secret": "pi_1663020464626204672_secret_KbWwv9WBTBMVMrYZOJh3A7UH",
"next_action": {
"type": "promptpay_handle_redirect",
"promptpay_handle_redirect": {
"url": "https://apitest.wooshpay.com/v1/receives/ipay88/pay/pi_1663020464626204672"
}
},
"payment_method_types": [
"promptpay"
],
"confirmation_method": "automatic",
"return_url": "https://your.website",
"payment_method": "pm_1663020464512958464",
"capture_method": "automatic"
}
Checkout
Payment flow
- Customer selects TrueMoney from the list of payment methods available and clicks on the Pay botton
- Customers will be redirected to TrueMoney's page. Scan QR and approve the payment
Create a Session
Request
{
"cancel_url": "www.wooshpay.com",
"mode": "payment",
"success_url": "https://wooshpay.com/",
"payment_method_types": ["truemoney"],
"line_items": [
{
"price_data": {
"currency": "THB",
"unit_amount": 2000,
"product_data": {
"name": "apple"
},
"billing_scheme": "testscheme",
"lookup_key": "test_lookup_key"
},
"quantity": 1
}
]
}
Response
{
"id": "cs_1680921737639755776",
"object": "checkout.session",
"created": 1689597947000,
"livemode": false,
"currency": "THB",
"customer": "",
"mode": "payment",
"status": "open",
"url": "https://checkouttest.wooshpay.com/pay/cs_test_1680921737639755776?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
"cancel_url": "www.wooshpay.com",
"line_items": {
"object": "list",
"data": [
{
"id": "li_1680921737673310208",
"object": "item",
"currency": "THB",
"description": "apple",
"price": {
"id": "price_1680921737681698816",
"object": "price",
"created": 1689597947000,
"livemode": false,
"active": false,
"currency": "THB",
"product": {
"id": "prod_1680921737694281728",
"object": "product",
"created": 1689597947000,
"livemode": false,
"active": false,
"name": "apple",
"updated": 1689597947000
},
"type": "one_time",
"unit_amount": 2000,
"billing_scheme": "per_unit",
"lookup_key": "test_lookup_key"
},
"quantity": 1,
"amount_subtotal": 2000,
"amount_total": 2000
}
]
},
"payment_intent": "pi_1680921737866248192",
"payment_method_types": [
"truemoney"
],
"payment_status": "unpaid",
"success_url": "https://wooshpay.com/",
"amount_subtotal": 2000,
"amount_total": 2000,
"billing_address_collection": "auto",
"expires_at": 1689684346928,
"payment_link": "",
"client_secret": "pi_1680921737866248192_secret_bKslLOpffohD4ni828W4Ilpu"
}
Next step
You can add more features to your integration as needed
Create a Webhook
Listen to events on your WooshPay account so your integration can automatically trigger reactions. Create a webhook that mainly focuses on enabled_events and url.
Create a Refund
Create a refund to repay funds to your customer. You can also perform partial refunds, but not every payment method supports them. A partial refund is when you refund only part of the original transaction amount.