越南支付接口接入全流程详解

越南支付接口接入全流程详解

一、前期准备阶段

  1. 市场调研与合规审查

    • 了解越南金融监管政策（SBV规定）
    • 确认目标支付方式（本地银行转账、电子钱包等）
    • 研究PCI DSS等国际安全标准要求

  2. 企业资质准备

    • 营业执照（需在越南注册或找到当地合作伙伴）
    • SBV颁发的支付业务许可证（如需要）
    • KYC/AML合规文件

  3. 技术环境评估

    • 服务器位置选择（建议东南亚节点）
    • HTTPS证书配置
    • IP白名单设置

二、主流支付渠道选择

A. 银行直连方案

  1. Vietcombank, VietinBank, BIDV等大型银行网关
  2. Napas国家支付开关接入

B. 第三方聚合平台

  1. OnePay (支持信用卡/借记卡)
  2. MoMo (市场份额最大的电子钱包)
  3. ZaloPay
  4. VNPAY-QR (二维码标准)

C.跨境支付方案

1.Payoo
2.Ngan Luong

三、技术对接流程(以VNPAY为例)

步骤1：商户注册
-提交企业资料至VNPAY官网(https://vnpay.vn)
-获取商户ID(Merchant ID)和哈希密钥(Hash Secret)

步骤2：API集成

// PHP示例代码(VNPAY)

$vnp_Url = "https://sandbox.vnpayment.vn/paymentv2/vpcpay.html";

$vnp_HashSecret = "YourHashSecret";



$inputData = array(

    "vnp_Version" => "2",

    "vnp_TmnCode" => $vnp_TmnCode,

    "vnp_Amount" => $amount *100,

    //...其他必填参数...

);



//生成签名

ksort($inputData);

$hashdata = "";

foreach ($inputData as $key => $value) {

    $hashdata .= urlencode($key)."=".

                urlencode($value)."&";

}

$vnpSecureHash = hash_hmac('sha512', 

                          rtrim($hashdata,'&'), 

                          $vnp_HashSecret);

步骤3：测试环境验证
-使用沙箱账户完成全流程测试：
订单创建→跳转支付→异步通知→查询接口

步骤4：生产环境部署
-更换为正式API端点
-配置IPN接收URL
-设置对账自动化流程

四、关键注意事项

1.货币处理:仅支持VND，金额需×100传输(无小数位)
2.语言支持:界面至少提供越南语+英语选项
3.退款规则:各通道退款时限不同(通常T+3工作日)
4.手续费结构:国内交易0

MoMo
ZaloPay