VietQR via 2C2P

​

Supported workflows

​

Before you begin

1. Set up a 2C2P integration in your workspace. Follow the 2C2P integration setup guide if you don’t have one yet. To refund VietQR payments, also add the merchant private key and the 2C2P public key to the integration.
2. Ask 2C2P to enable VietQR on your 2C2P merchant account.
3. In the Payrails Portal, go to Settings → Integrations, open your 2C2P integration, select VietQR under Payment methods, and save.
4. Add VietQR as a payment option in your workflow.

​

Request fields for 2C2P

​

Authorize a VietQR payment

{
  "amount": {
    "value": "700000",
    "currency": "VND"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "vietQR",
      "amount": {
        "value": "700000",
        "currency": "VND"
      }
    }
  ],
  "meta": {
    "order": {
      "description": "Order 1234 at Example Store"
    },
    "customer": {
      "name": "Linh",
      "lastName": "Tran",
      "email": "linh.tran@example.com",
      "country": {
        "code": "VN"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How 2C2P handles VietQR

• 2C2P shows the QR code on its hosted payment page. For VietQR, Payrails leaves out card and 3D Secure data, and it sends no address or browser data.
• VietQR through 2C2P is a sale: 2C2P settles the payment on success. VietQR has no separate capture or cancel step.
• Payrails sends the execution’s merchant reference to 2C2P as the invoice number. 2C2P rejects an invoice number it has already received, so use a new merchant reference for each payment.
• The customer’s return to your site doesn’t carry a signed result. Payrails queries 2C2P for the payment status, and 2C2P also sends a signed notification.
• Refunds use 2C2P’s maintenance API and need the merchant private key and the 2C2P public key on your integration.