FoxPay Integration

Introduction#

FoxPay electronic payment gateway is integrated in online transaction websites and applications, helping customers pay quickly and easily. Meanwhile, Foxpay e-wallet is an application developed on a high-tech platform that can be installed on any mobile device using iOS and Android operating systems. Payment solutions with e-wallets help users save time and costs compared to traditional forms of transactions.

Supported Countries#

Vietnam 🇻🇳

Available payment methods:#

Foxpay PG only supports VND(₫) currency.

Payment Type	Payment Method Key	Status	Sandbox Availability
Local ATM Card	`FOXPAY_ATM_CARD`	✅	✅
Foxpay Credit Card	`FOXPAY_CREDIT_CARD`	✅	✅
Foxpay Wallet	`FOXPAY_WALLET`	✅	❌
Foxpay All	`FOXPAY_ALL`	✅	✅

Miscellaneous Details#

Refunds can be initialized from the merchant portal, refund status can be checked at both merchant portal and 9Pay Dashboard

Configure ReturnUrl and IPNUrl#

Please request FoxPay team to configure ReturnUrl and IPNUrl for your account, Please find IPN URL in Admin portal payment credentials setting page

RedirectUrl : https://api.portone.cloud/api/handleShopperRedirect/FOXPAY
IPNUrl : https://api.portone.cloud/webhook/foxpay/${PORTONEKEY}

Sandbox#

Credentials#

Key	Value
merchantId	as provided by FoxPay
terminalId	as provided by FoxPay
secretKey	as provided by FoxPay

Test Credit cards data#

Type	Card number	Name	Valid through	CVV	Password
Visa	4000000000000002	NGUYEN VAN A	12/22	111	1234

Test ATM cards data#

Type	Card number	Name	Valid through	OTP
ATM Card	9704000000000018	NGUYEN VAN A	03/07	otp

Use following values in embedded JS code to pay via Foxpay channel#

    "pmt_channel": "FOXPAY",
    "pmt_method": { Any of above given payment method keys },