Place Order

POST /api/v1/placeOrder

Endpoint use to Place an Order.

Please use environment variable Payment.

⚠️Please notice: Order created has not be verified. Please call verifyOrder API

⚠️Please be caution: These QR string was meant to be use in SANDBOX. DO NOT USE IT IN PRODUCTION

To test with VND please use this QR String:

qrString: "00020101021126400010vn.zalopay0115uvsgayNI4Xsrqwz020300238620010A00000072701320006970454011899ZP24250M421803650208QRIBFTTA5204739953037045802VN63041428"

To test with PHP please use this QR String:

qrString: "00020101021127590012com.p2pqrpay0111UBPHPHMMXXX02089996440304121096459500755204601653036085802PH5925Sophia Marie Chavez Dever6009SAN PEDRO63043708"

Body Params:

Request

Param	Type	Required	Explain	Additional
qrString	string	Yes	QR String
amount	number	Yes	Amount in Fiat
fiatCurrency	enum	No	Fiat Currency	["VND", "PHP"]
Default: Corresponding to qrString currency
cryptoCurrency	string	Yes	Crypto Currency	Currently only USDC supported
fromAddress	string	Yes	From Wallet Address
chain	enum	No	Chain Name	["Solana", "Ethereum", "Polygon", "Arbitrum", "Base"]

Default to: Solana | | transactionReference | string | No | Transfer Content | Default to: Crypto payout orderId |

Response

Param	Type	Required	Explain
orderId	string	Yes	Order ID
status	string	Yes	Status of Order
fiatAmount	number	Yes	Fiat Amount
fiatCurrency	string	Yes	Fiat Currency
cryptoAmount	number	Yes	Crypto Amount
cryptoCurrency	string	Yes	Crypto Currency
exchangeRate	number	Yes	Exchange Rate (1 USC = ? VND)
qrInfo	QRInfo	Yes	QR Information
cryptoTransferInfo	object	Yes	Crypto Transfer Information
timestamp	string	Yes	Time Stamp
transactionReference	string	No	Transfer Content

QRInfo (type)

Param	Type	Required	Explain
encodedString	string	Yes	QR String
providerInfo	object	No	QR Provider Information
bankInfo	object	No	Bank Information
amount	number	No	Amount that defined in the QR
purpose	string	No	Purpose of the transfer
additionalData	string	No	Additional Data
beneficiaryName	string	No	Beneficiary Name of Recipient
countryCode	string	No	Country Code

cryptoTransferInfo (object)

Param	Type	Required	Explain
chain	string	Yes	Chain Name
fromAddress	string	Yes	From Address Wallet
toAddress	string	Yes	To Address Wallet
token	string	Yes	Token Address
amount	number	Yes	Amount
encodedTransaction	string	No	Encoded Transaction

providerInfo (object)

Param	Type	Required	Explain
name	string	No	Type of the Service
guid	string	No	GUID
service	string	No	Name of Provider

bankInfo (object)

Param	Type	Required	Explain
bankBin	string	No	Bank Bin Code
bankNumber	string	No	Bank Account Number

Error

Param	Type	Required	Explain
error	string	Yes	Error
message	string	Yes	Message of Error