Skip to main content

​
The payin flowchart

flowchart

​
Request URL

  • https://gateway.pay247.io/gateway/payin/create

​
Request Method

  • POST

​
Request Parameters

ParameterMustTypeExplanation
mch_idYesstringMerchant ID
mch_order_noYesstringMerchant Order NO.
mch_user_idYesstringMerchant User ID（You can use md5 to encrypt it）
currencyYesstringSupport【CNY,JPY,PHP,THB, Please Contact BD】
amountYesstring99.11
pay_methodNostringIf leave it empty， the user will use our cashier to choose pay method
pay_themeNostring’link’: pay247 cashier, ‘custom’: return pay params for custom cashier, If leave it empty， the user will use our cashier,
client_ipYesstringThe IP address of the ordering user (must be the user’s real IP).
notify_urlYesstringIf the order changed will notify the server url
return_urlNostringIf paid success, will return to this url
payer_idNostring[Some pay method needs] the payer ID.
payer_nameNostring[Some pay method needs] the payer name
payer_phoneNostring[Some pay method needs] the payer phone
payer_account_noNostring[Some pay method needs] the payer account_no
payer_addressNostring[Some pay method needs] the payer address
timestampYesstringtimestamp millisecond
versionYesstringv1.0
uuidYesstringRequest ID: 550e8400-e29b-41d4-a716-446655440000
signYesstringSignature

​
Optional Parameters

CurrencyPay methodRequired
🇹🇭 THBBANKpayer_name, payer_account_no
🇯🇵 JPYBANKpayer_name, payer_address

​
For example

{
  "mch_id": "Q0P5T8DOGN10000",
  "mch_order_no": "TRADE-405189",
  "mch_user_id": "U405189",
  "currency": "CNY",
  "amount": "99.11",
  "pay_mehod": "GCASH",
  "pay_theme": "link",
  "notify_url": "https://x.com/notify",
  "return_url": "https://x.com/return",
  "timestamp": "1693233334134",
  "version": "v1.0",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "sign": "81930c5a04d1c58fd1efe33b06e2ffa7"
}

​
Response Data

ParameterMustTypeExplanation
mch_idYesstringMerchant ID.
order_noYesstringSystem Order No.
mch_order_noYesstringMerchant Order No.
currencyYesstringCNY、 THB、PHP、VND… See more at backoffice
amountYesstring99.11
pay_methodYesstringpay method
pay_themeYesstringpay theme, link: pay247 cashier, custom: for merhcant to custom cashier
pay_urlOptionalstringpayment url for theme of link, need to redirect here
pay_paramsOptionalobjectpayment params for theme of custom, need to custom cashier page
statusNostringThe order status

​
For example (Cashier)

{
	"code": 0,
	"message": "success",
	"uuid": "550e8400-e29b-41d4-a716-446655440000",
	"timestamp": "1693233334134",
	"data": {
		"mch_id": "MCH12345678",
		"mch_order_no": "23082822325936693122",
		"order_no": "MO202308282232593669984082",
		"currency": "USD",
		"amount": "59.12",
		"pay_method": "BANK",
		"pay_theme": "link",
		"status": "PENDING",
		"pay_url": "https://pay.xxx.com/link/DyDpCjDfkr"
	}
}

​
For example (Custom) Support JPY

{
	"code": 0,
	"message": "success",
	"uuid": "550e8400-e29b-41d4-a716-446655440000",
	"timestamp": "1693233334134",
	"data": {
		"mch_id": "MCH12345678",
		"mch_order_no": "23082822325936693122",
		"order_no": "MO202308282232593669984082",
		"currency": "USD",
		"amount": "59.12",
		"pay_method": "BANK",
		"pay_theme": "custom",
		"status": "PENDING",
		"pay_params": {
			"payee_name": "日本測試卡",
			"payee_account_no": "123",
			"payee_bank_name": "三菱UFJ銀行",
			"payee_branch_name": "日本測試卡",
			"qr": ""
		}
	}
}

​
For example (Custom) Support INR

{
	"code": 0,
	"message": "success",
	"uuid": "219bf2a2-8994-4ab0-b850-a5c1c70316e5",
	"timestamp": 1756736237009,
	"data": {
		"mch_order_no": "1119132492",
		"order_no": "PI202509012031309225639045",
		"currency": "INR",
		"amount": "23000.00",
		"pay_method": "UPI",
		"fee": "1495.00",
		"pay_theme": "custom",
		"utr": "395141536523",
		"error": null,
		"status": "PENDING",
		"pay_params": {
			"payee_name": "AJ ENTERPRISE",
			"payee_account_no": "ajenter66@sbi",
			"payee_bank_name": "",
			"payee_branch_name": "",
			"qr": "upi://pay?pa=ajenter66@sbi&pn=AJ ENTERPRISE&tn=O04T&am=22999.48&cu=INR&featuretype=money_transfer",
			"payee_phone": ""
		}
	}
}