# VNLIFE / VNPAY

> VNLIFE is the Vietnamese technology and financial-services holding group behind VNPAY (Vietnam Payment Solution JSC), the leading electronic-payment provider in Vietnam. Its flagship is the VNPAY-QR payment gateway — a redirect + IPN HTTP API secured with HMAC-SHA512 checksums, supporting QR, domestic ATM/bank-account, international card, tokenization and installment payments across 40+ banks and 15+ e-wallets. Backed by SoftBank Vision Fund and GIC.

## APIs

- [VNPAY Payment Gateway (developer portal)](https://sandbox.vnpayment.vn/apis/): vpcpay redirect + IPN + merchant web API (query/refund).
- [Payment integration reference](https://sandbox.vnpayment.vn/apis/docs/thanh-toan-pay/pay.html): vnp_ parameters, HMAC-SHA512 vnp_SecureHash, Return/IPN flow, response codes.
- [Sandbox / try it now](https://sandbox.vnpayment.vn/tryitnow/Home/CreateOrder): hosted test order creator with published test cards.

## Docs

- [Developer portal](https://sandbox.vnpayment.vn/apis/)
- [Getting started / integration guide](https://sandbox.vnpayment.vn/apis/docs/huong-dan-tich-hop/)
- [Error / response code reference](https://sandbox.vnpayment.vn/apis/docs/bang-ma-loi/)

## Artifacts (API Evangelist enrichment)

- Authentication: authentication/vnlife-authentication.yml (HMAC-SHA512 + vnp_TmnCode)
- Decline / response codes: errors/vnlife-decline-codes.yml
- Error catalog (IPN + status): errors/vnlife-problem-types.yml
- Conventions (idempotency via vnp_TxnRef, amount x100, GMT+7): conventions/vnlife-conventions.yml
- Lifecycle (vnp_Version 2.1.0): lifecycle/vnlife-lifecycle.yml
- Sandbox / test cards: sandbox/vnlife-sandbox.yml
- Conformance (PCI DSS 3.2.1 Level 1): conformance/vnlife-conformance.yml
- MCP candidate tools: mcp/vnlife-mcp.yml

## Company

- [VNPAY website](https://vnpay.vn)
- [About](https://vnpay.vn/ve-chung-toi)
- [News](https://vnpay.vn/tin-tuc)
- [Contact / support](https://vnpay.vn/lien-he)
- [Careers](https://tuyendung.vnpay.vn)