Thailand Cash Payments

Consumers can make cash payments in Thailand through the Lotus's convenience stores. This is a simple alternative to paying online with credit/debit cards or by bank transfer and is used throughout Thailand. The process starts with the consumer shopping online and receiving a generated barcode. The consumer takes this barcode to the register of the convenience store and pays in cash. Lotus's have over 2,300 locations in the country, including some stores that are open 24 hours per day.

Suggest Edits
Available country codesTH
Processing (Presentation) currenciesTHB
Settlement currenciesUSD
Consumer currenciesTHB
Channel member tagrestomisetescolotus, thaicash
Scheme name in the settlement fileThai Cash, Tesco Lotus
Minimum transaction amountTHB 1.00
Maximum transaction amountTHB 10,000
Session timeout48 hours 30 mins
RefundNo
Refund ValidityN/A
Chargeback
Integration TypeAsynchronous
SandboxPPRO-hosted

Transaction Flow

  1. Consumer goes to the merchant's payment page and selects Convenience Store.
  2. Merchant or PSP sends a transaction request to PPRO.
  3. PPRO sends a transaction request to Razer.
  4. A redirect URL is made and sent to the merchant or PSP.
  5. The merchant forwards the redirect URL to the consumer's browser.
  6. Razer shows a generated barcode to the consumer, and also the time the barcode expires.
  7. The consumer goes to the convenience store and pays at the cash register. The store notifies Razer of the payment result.
  8. Razer sends the notification of the payment result to PPRO.
  9. PPRO returns the transaction response to the merchant or PSP.
  10. If the transaction status is unknown, PPRO sends a check status call to Razer.
  11. Razer returns the result.

Thai Cash Integration

Input parameters for the TRANSACTION Call

Field NameM/O/CTypeRegExDescription
specin.emailMasciiStandard email validation.The consumer's email address.
specin.phoneMasciiStandard phone number validation.The consumer's phone number.

For standard input parameters, see Input parameters for the TRANSACTION call.

This payment method supports the dynamic descriptor field (see The dynamic descriptor).

Output Parameters for the TRANSACTION Call

There are no specific output parameters for the transaction call.

For standard output parameters, see Output parameters for the TRANSACTION call.

Transaction Call Input

&tag=thaicash
&txtype=TRANSACTION
&countrycode=TH
&currency=THB
&amount=250
&merchanttxid=84564142227
&login=johndoe
&password=wXBrpVporFVjGO4R
&contractid=JOHNDOETESTCONTRACT
&channel=testchannel
&merchantredirecturl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Flanding.php
&notificationurl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Fnotification.php
&accountholdername=Tester+Doe
$specin.dynamicdescriptor=testdescription
&specin.email=example%40example.com
&specin.phone=0123834753
&returnmode=urlencodeext

Transaction Call Output

STATUS=SUCCEEDED
&TXID=600520459
&ERRMSG=
&CHANNEL=testchannel
&MERCHANTTXID=84564142227
&TAG=thaicash
&REDIRECTSECRET=JRZ4jcuQVMFnF8yf0hOFypwWd1D5dU2u
&FUNDSSTATUS=WAITING

Updated 7 months ago