Introduction

This document is the only official documentation for Pay247. Updates to the capabilities provided by the Pay247 API will be continuously published here, so please stay tuned.

Request Method: POST

Request Header:

"Content-Type":"application/json;charset=UTF-8"

Response Header:

"Content-Type":"application/json;charset=UTF-8"

Timezone

The timezone used by the API is UTC+8

Common parameters

common request parameters

Parameter	Must	Type	Explanation	Example
mch_id	YES	string	Merchant ID	SVSPYS63XM10042
timestamp	YES	int	Timestamp (integer; milliseconds recommended)	1594047539321
version	YES	string	Version	v3.0
uuid	YES	string	Request ID; required for every merchant request and included in the signature	550e8400-e29b-41d4-a716-446655440000
sign	YES	string	Signature	b05a16b1e92aa4948e164b747b5749b4

Every merchant request to the gateway (including create, query, update, approval, balance, and payment-method discovery) must include uuid and include it in the signature.

common response parameters

Parameter	Must	Type	Explanation	Example
code	YES	int	code , see dict below	0
message	YES	string	message	success
uuid	YES	string	Response ID (from header or server)	550e8400-e29b-41d4-a716-446655440000
timestamp	YES	int	timestamp	1599047539321
data	YES	mixed	data

System Code

Code

code	Explanation
0	success
4000	Invaild Paramters
4001	The mch order no is repeated
4002	The order amount does not meet the limit requirements.
4040	The mch order not exist
5000	System error， if your order is payout, should call the payout query api to check the order
5001	Insufficient wallet balance for payout

Pay Theme

pay_theme

value	Explanation
link	System default cashier
custom	Merchant custom cashier，will return bank cards to merchant.

Pay Method

See Payment methods and availability for all codes and the merchant availability endpoint. The original currency and method examples are retained below. Availability still depends on merchant configuration. For crypto, use pay_method=CRYPTO and set network to TRC20 or another supported network; TRC20 and ERC20 are not payment method codes.

Currency	Direction	Method	Description
USDT	payin	CRYPTO	Tron network: `network=TRC20`
USDT	payout	CRYPTO	Tron network: `network=TRC20`
INR	payin	UPI	UPI QR
INR	payin	UPI_INTENT	UPI intent
INR	payout	BANK	IFSC bank transfer
PHP	payin	GCASH	GCash wallet
PHP	payin	MAYA	Maya wallet
PHP	payout	BANK	Bank transfer

Quickstart

Balance

Payin

Payout

Reference

Request Method: POST

Request Header:

Response Header:

Timezone

Common parameters

System Code

Pay Theme

Pay Method

​Request Method: POST

​Request Header:

​Response Header:

​Timezone

​Common parameters

​System Code

​Pay Theme

​Pay Method

Request Method: POST

Request Header:

Response Header:

Timezone

Common parameters

System Code

Pay Theme

Pay Method