Create the currency type VND by accessing the admin and selecting the 'E-Commerce > Currencies' menu, click on create button, and then fill in the information as follows:

Sandbox Environment

To integrate the sandbox environment, you will need to create a bank named NCB by accessing the admin and navigating to the 'E-Commerce > Banks' menu, click on create button, then fill in the information as follows:

Integrating the sandbox environment is relatively straightforward. Access the admin interface, navigate to the 'E-Commerce > Payment Services' menu. Then select VNPay from the list and fill in the information as follows:

1. Name: VNPay.
2. Version: 2.1.0.
3. Bank: Select NCB.
4. Currency: Select VND.
5. Service URL: Fill in: https://sandbox.vnpayment.vn/paymentv2/vpcpay.html
6. Service API URL: Fill in https://sandbox.vnpayment.vn/merchant_webapi
7. Callback URL: Leave it default.
8. Client key: You can use: DEMOV210.
9. Secret key: You can generate a random string.
10. Status: Choose Activated.

Save your changes, then try checking out an order to see the VNPay payment option. Select VNPay for payment and use the following account to pay:

Bank: NCB
Card number: 9704198526191432198
Cardholder name: NGUYEN VAN A
Issue date: 07/15
OTP password: 123456

Or you can choose any account here.

Production Environment

Integrating the production environment is relatively complex. You will need to sign a contract with VNPay and integrate it with the technical team through a series of steps.

Steps to sign the contract

1. Firstly, you must be a legal entity.
2. Leave your contact information here. Then wait for VNPay staff to contact you via email.
3. VNPay staff will send you an email with the 'Service Usage Registration Form' and 'Service Usage Contract'. You will need to fill out both forms, sign, stamp, and send them back. Note that VNPay requires a lot of documents to verify your business, from photos, office videos, business registration licenses, domain ownership proofs... You should compile all the files into one place, for example, a Google Drive folder, and share it with them. Additionally, your website must default to displaying VND currency and must show complete business information such as address, tax ID at the footer of the website to be accepted.
4. After signing the contract, VNPay staff will send you an email about sandbox environment information and initiate a Skype chat group. Join this group to start the technical integration process.

Technical integration steps

1. You will need to deploy ezyplatform on a server with a domain and HTTPS connection, let's assume it's example.com.
2. After receiving sandbox environment information via email, go to the 'E-Commerce > Payment Services' menu of example.com. Then select VNPay from the list and fill in the information as follows:
3. Name: VNPay.
4. Version: 2.1.0.
5. Bank: Select NCB.
6. Currency: Select VND.
7. Service URL: Fill in: https://sandbox.vnpayment.vn/paymentv2/vpcpay.html
8. Service API URL: Fill in https://sandbox.vnpayment.vn/merchant_webapi/
9. Callback URL: Leave it default.
10. Client key: Use the vnp_TmnCode identifier you received in the sandbox environment email.
11. Secret key: Use the secretKey security code you received in the sandbox environment email.
12. Status: Choose Activated.

Save your changes.

3. Now, log in to https://sandbox.vnpayment.vn/vnpaygw-sit-testing/order/instruction. Use the login name and password you received in the sandbox environment email.
4. Or access the IPN URL configuration section https://sandbox.vnpayment.vn/vnpaygw-sit-testing/ipn. Assuming your domain is example.com, enter the value of IPN as: https://example.com/payment/verify/VNPAY and save it.
5. Testing phase, this step is quite complicated, so focus carefully, read this guide thoroughly before starting, and remember it well.

• You need to create 2 new transactions up to the OTP step. This is to create test cases.
• Test until all tests are successful.
• Remember the order ID and the time you clicked the test button so that you can view the logs in nginx during acceptance testing and fill in the test record.

6. After testing, inform VNPay's technical team in the Skype group.
7. VNPay's technical team will check, if there are no issues, they will send you IPs and ask you to add them to the whitelist. The IPs could be:

Sandbox environment: 113.160.92.202.

Production environment:

113.52.45.78
116.97.245.130
42.118.107.252
113.20.97.250
203.171.19.146
103.220.87.4
103.220.86.4

8. You will need to install EzyDefence, activate it, restart, and then go to the 'EzyDefence > Whitelist' menu and add a record containing all the IPs above like this:

9. Go back to the Skype group and notify VNPay's technical team to confirm that IPs outside the whitelist cannot call the API.
10. If there are no issues, they will send you a test record, fill in the necessary information, sign, stamp, and send it back.
11. After receiving the test record, they will send you another email containing information about the production environment.
12. You will need to create a bank named VNPAY

QR by accessing the admin and navigating to the 'E-Commerce > Banks' menu, click on create button, then fill in the information as follows:

Note to set the status to Archived to avoid displaying the bank on the end-user website interface.

13. Update the information of the VNPay settings by going back to the 'E-Commerce > Payment Services' menu of example.com. Then select VNPay from the list and fill in the information as follows:
14. Name: VNPay.
15. Version: 2.1.0.
16. Bank: Select VNPAYQR.
17. Currency: Select VND.
18. Service URL: Fill in: https://pay.vnpay.vn/vpcpay.html
19. Service API URL: Fill in https://pay.vnpay.vn/merchant_webapi
20. Callback URL: Leave it default.
21. Client key: Use the vnp_TmnCode identifier you received in the production environment email.
22. Secret key: Use the secretKey security code you received in the production environment email.
23. Status: Choose Activated.
24. Test again by creating a real transaction with a small amount.

Congratulations! You have successfully integrated VNPay!