Skip to content

Logo

WanguPay

WanguPay has across the globe to make payments effortless. We are committed to building the most stable payment system in the world and leading the future with international payments.

Supports in this guide: Payments, Payouts

Provider website: wangupay.com

What you need to do for start processing transactions (brief summary)

  1. Get your credentials (from WanguPay)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from WanguPay

Contact your WanguPay account manager (or submit a request at wangupay.com/contact) to get your account verified and receive the following credentials.

  • Merchant ID -> Corefy field merchant_id.
  • Public key -> Corefy field public_key.
  • Private key -> Corefy field private_key -> used to sign your requests; pasted as text, not uploaded as a file.

VND only.

Payments processing (connect Provider account, create payment-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open WanguPay in the provider directory and press Connect at WanguPay Provider Overview page in the New connection section.

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Public key
  • Private key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected WanguPay Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to WanguPay's hosted page. Two methods are available: MoMo e-wallet (momo_vnd_hpp) and QR online banking (online_banking_qr_vnd_hpp).

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6f7a8b9c-0d1e-4f2a-8b13-6c7d8e9f0a1b",
      "service": "momo_vnd_hpp",
      "currency": "VND",
      "amount": 50000
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "7a8b9c0d-1e2f-4a3b-8c24-7d8e9f0a1b2c",
      "service": "momo_vnd_hpp",
      "currency": "VND",
      "amount": 50000,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe"
      }
    }
  }
}

Important

customer.name is sent to WanguPay as the customer's display name; if it's missing, the name Constant below is used instead.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Constants (fallback fields)

Constants are static values that Corefy can send to the provider instead of dynamic data from your API request, when those fields are missing in the request.

Priority (predictable rule): 1. If a value is present in the request -> Corefy uses the request value 2. Else if the constant is set -> Corefy uses the constant 3. Else -> provider may reject the request or apply its defaults (depends on provider)

Currently available constants (constant -> Corefy API field)

  • NAME -> customer.name -> fallback customer display name, set separately per service (momo_vnd_hpp and online_banking_qr_vnd_hpp each have their own constant value).

Refunds

WanguPay does not support refunds.

Payouts processing (connect the same Provider account, create payout-invoice)

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds to the recipient's MoMo wallet.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "8b9c0d1e-2f3a-4b4c-8d35-8e9f0a1b2c3d",
      "service": "momo_vnd",
      "currency": "VND",
      "amount": 50000,
      "fields": {
        "account_number": "01747947921"
      }
    }
  }
}

Important

fields.account_number is required - this is the recipient's MoMo-linked phone number/account.

Payout - MAX

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "9c0d1e2f-3a4b-4c5d-8e46-9f0a1b2c3d4e",
      "service": "momo_vnd",
      "currency": "VND",
      "amount": 50000,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "customer@example.com"
      },
      "fields": {
        "account_number": "01747947921"
      }
    }
  }
}

customer.name and customer.email are forwarded to WanguPay as the recipient's name and email, if provided.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Refunds

WanguPay does not support refunds.

Additional info

  1. Active reconciliation is available - both Payments and Payouts support an active status request from Corefy to WanguPay, in addition to WanguPay's own asynchronous callback for Payments.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the merchant ID, public/private key pair and test_mode setting match the environment you're connecting to
  • Currency or service is not supported -> only VND (momo_vnd_hpp, online_banking_qr_vnd_hpp, momo_vnd) is available for this connector
  • Payout fails with a missing recipient error -> confirm fields.account_number is set to the recipient's MoMo-linked phone number/account

Question

Still looking for help connecting your WanguPay account? Please contact our support team!