VNLIFE · Authentication Profile

Vnlife Authentication

Authentication

VNLIFE secures its APIs with checksum-signature and merchant-credential across 2 declared security schemes, as derived from its OpenAPI definitions.

CompanyFintechPaymentsPayment GatewayQR PaymentsE-CommerceVietnamFinancial-Services
Methods: checksum-signature, merchant-credential Schemes: 2 OAuth flows: API key in:

Security Schemes

MerchantTerminal credential
SecureHash signature

Source

Authentication Profile

vnlife-authentication.yml Raw ↑
generated: '2026-07-21'
method: searched
source: https://sandbox.vnpayment.vn/apis/docs/thanh-toan-pay/pay.html
docs: https://sandbox.vnpayment.vn/apis/docs/huong-dan-tich-hop/
summary:
  types: [checksum-signature, merchant-credential]
  transport: query-string (redirect) + server-to-server IPN
  scheme: HMAC-SHA512 message signature
note: >-
  VNPAY has no OAuth/API-key bearer flow. Merchants are provisioned a Terminal
  code (vnp_TmnCode) plus a secret hash key (vnp_HashSecret). Every request and
  callback is signed with an HMAC-SHA512 checksum over the alphabetically-sorted,
  URL-encoded vnp_ parameter set (excluding vnp_SecureHash), placed in
  vnp_SecureHash. The receiver recomputes and compares to authenticate.
schemes:
- name: MerchantTerminal
  type: credential
  parameter: vnp_TmnCode
  description: Merchant/terminal identifier issued by VNPAY on onboarding.
- name: SecureHash
  type: signature
  algorithm: HMAC-SHA512
  parameter: vnp_SecureHash
  secret: vnp_HashSecret
  canonicalization: >-
    Sort vnp_ parameters alphabetically by key, URL-encode values, concatenate
    key=value pairs with '&' (excluding vnp_SecureHash and vnp_SecureHashType),
    then HMAC-SHA512 with the merchant HashSecret.
  applies_to:
  - Payment URL creation (vpcpay redirect)
  - Return URL verification
  - IPN callback verification
  - Merchant web API (transaction query / refund)

Work with this as data

Every security artifact here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for security posture

4 MCP tools reach this
  • find_securityBrowse and filter every security artifact in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This security artifact
curl "https://apis.io/api/v1/security/vnlife-authentication"
All security posture
curl "https://apis.io/api/v1/security?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.