Version Info

Overview

Introduction

This document describes the payment integration between VTC Pay Gateway in the role of payment service provider and Merchant Shop (system of partner) in the role of sales organization, using online payment methods of VTC Pay via VTC Pay e-wallet and bank accounts (domestic and international internet banking).

This document describes functions which are necessary for integration, information transmission between two parties’ systems.

This document describes database stream that interacts between two systems in transaction process.

Definition of data exchange standards, safety solutions as well as authenticating transaction source.

Alpha Test Parameters

VTC Pay web address to register website integration, check transaction history :

http://alpha1.vtcpay.vn/wallet

Url sending order payment information :

http://alpha1.vtcpay.vn/portalgateway/checkout.html

Test Account:

Merchant test account to login VTC Pay to register website integration, check transaction history :

Account:  0963465816
Password: Aa@123456

Customer’s VTC Pay e-wallet account to test order payment :

Account:  0357758300
Password: Abcd1234

Customer’s Visa Card test order payment by international card :

Card Number:  4111111111111111
Zip/Postal Code:  123
CardType:  Visa
CVN:  123
Exprition Date:  01/2020
Other fields:   whatever in correct format

Golive Parameters

Website VTC Pay:

https://vtcpay.vn/

Url sending order payment information:

https://vtcpay.vn/bank-gateway/checkout.html

Note: Test and Golive Parameters are different, therefore, in this mode, Merchant need a valid VTC Pay e-wallet account:
- To register website integration.
- To receive money after successful transactions.

Website Integration Registration Tutorials

To register payment integration via VTC Pay, Merchant need to login VTC Pay e-wallet account, access to menu "Payment integration – Website Integration” to register an integration website. VTC Pay will show the interface that manages Merchant’s integration websites. Fill in necessary information and follow the instruction to complete integration registration.

Ex:

Note:

- Url Receiving: the address that receives order payment transaction result from VTC Pay according to POST. As in the example, it should be http://www.kidsplaza.vn/listen.html

- If Url Redirect is not on order, VTC shall redirect customers to Url Receiving.

- Website Secret Key: As information added when creating signature by SHA256 . Secret Key must include numbers, uppercase letter, lowercase letter, and have at least 16 characters.

- Transaction Fees: Merchants choose either buyers or sellers to be charged. Ex: A $100 oder with fee of $3, in case :
- Sellers be charged: Buyers spend $100, Sellers get $(100-3).
- Buyers be charged: Buyers spend $(100+3), Sellers get $100.

Programming Payment Integration

Payment Diagram using bank account :

Merchant request Parameters

Note: The value of the url request parameter requires encode (urlencode)

(*). Compulsory Fields :
        Y: Must transmit to url
        N: Maybe null, empty or no need.

Signature: This is an example with full parameters in the following order:

amount|bill_to_address|bill_to_address_city|bill_to_email|bill_to_forename|bill_to_phone|bill_to_surname|currency|language|payment_type|receiver_account|reference_number|transaction_type|url_return|website_id|settlement_ccy|SecurityCode	

amount|bill_to_address|bill_to_email|bill_to_forename|bill_to_phone|bill_to_surname|currency|language|payment_type|receiver_account|reference_number|website_id|settlement_ccy|SecurityCode

Returned result according to POST (server to server)

HTTP POST is the connection form of Server to Server. Data will be posted from VTC Pay server to receiving site at Merchant server that’s the site when creating website integration. VTC always posts transaction result to this receiving site. Processing result posted by VTC is optional. However, Merchant should analyze the result posted by VTC because:

⇒ It helps Merchant receive the result all time, avoid not receiving the result if using HTTP Get, in case customers turn off their browser in transaction process or problems of the internet connection.

⇒ It helps Merchant receive the final result, special with verified transactions that need to be approved by VTC admin.

Parameters of order payment result that VTC Pay return to Merchant’s site:

Note: When receiving the result returned, Merchant has to check amount of money returned and amount of money sent to VTC Pay is correct or not. If it is not correct, the result returned is invalid, need to contact with VTC to check again.

Returned result according to HTTP GET

After finishing checkout process, VTC Pay shall redirect customer to receving site of Merchant, and return the payment result to Merchant at the same time through parameters on Url.

Details of returned parameters:

Appendix

Appendix of order payment

Appendix of banks list