概述
本文档介绍如何将 Google Pay 通过服务器直连接入 Oceanpayment,包括支付参数提交、交易处理及结果返回,帮助商户快速了解整体对接流程。
如需使用其他方案接入 Google Pay,请参阅 Google Pay 接入文档。
开始之前
- 使用 Google Pay 服务器对服务器集成时,商户需要注册 Google Pay 官方开发者账号,调用 Payment Token 流程获取卡信息 Token,再将该 Token 作为参数传递给 Oceanpayment。
- Google Pay 支持中国(CN)主体进行开发者注册,但实际商户入驻及线上支付能力可能受 Google Pay 区域准入政策限制。在生产环境中,部分收单、结算及商户审核能力仅对支持地区(如 HK / SG / EU / US 等主体)开放,建议根据业务需求选择符合 Google Pay 支持区域的主体进行商户配置。
流程图
请求
1. 注册 Google Developer
- 访问 https://pay.google.com/about/business
- 使用公司 Gmail / Google Workspace 注册;
- 选择企业账号。
2. 创建 Merchant ID
- 注册完成后会生成商户 ID,在 Google Pay Console → API access → Merchant Info 查看。
3. 配置 Google Pay API Key
- 在 Google Cloud Console 创建项目;
- 启用 Google Pay API for Web / Android;
- 获取 API Key。
4. 配置 Merchant Domain 白名单
- 登录 Google Developer → Google Pay API → Web integration;
- 提交域名白名单以及支付流程截图。
5. 获取 Payment Token
商户在用户完成支付授权后获取 Google Pay Payment Token,查看 Google Pay 完整示例。
信息
merchantInfo 可使用 Oceanpayment 的 MID 进行传值。如需使用该配置,请联系 Oceanpayment 技术支持获取。此时,第4步中的配置 Merchant Domain 白名单将由 Oceanpayment 开发者进行配置。
- Request
const paymentsClient = new google.payments.api.PaymentsClient({ environment: 'TEST' });
const request = {
apiVersion: 2,
apiVersionMinor: 0,
allowedPaymentMethods: [{
type: 'CARD',
parameters: {
allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
allowedCardNetworks: ['VISA', 'MASTERCARD'],
},
tokenizationSpecification: {
type: 'PAYMENT_GATEWAY',
parameters: {
'gateway': 'oceanpayment',
'gatewayMerchantId': 'oceanpayment',
},
},
}],
merchantInfo: {
merchantName: 'OceanPayment',
merchantId: 'BCR2DN4TWW...',
},
transactionInfo: {
totalPriceStatus: 'FINAL',
totalPrice: '10.00',
currencyCode: 'USD',
},
};
paymentsClient.loadPaymentData(request).then(paymentData => {
const token = paymentData.paymentMethodData.tokenizationData.token;
//发送 token 到服务端进行交易处理
});
- Response
//Google Pay Payment Token
{
"apiVersion": 2,
"apiVersionMinor": 0,
"paymentMethodData": {
"type": "CARD",
"description": "Visa •••• 1111",
"info": {
"cardNetwork": "VISA",
"cardDetails": "1111"
},
"tokenizationData": {
"type": "DIRECT",
"token": "{\"signature\":\"MEQCIB...\",\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"...\\\",\\\"ephemeralPublicKey\\\":\\\"...\\\",\\\"tag\\\":\\\"...\\\"}\"}"
}
}
}
6. card_type 传参说明
商户需将 paymentMethodData.info.cardNetwork 的返回值转换为 Oceanpayment card_type支持的枚举值,再传递该参数。
paymentMethodData.info.cardNetwork | card_type |
|---|---|
| VISA | VISA |
| MASTERCARD | MASTERCARD |
| MAESTRO | MAESTRO |
| JCB | JCB |
| ELO | ELO |
| DISCOVER | DISCOVER |
| CHINAUNIONPAY | CHINAUNIONPAY |
| CARTESBANCAIRES | CARTESBANCAIRES |
| AMEX | AMEX |
- Request
-d 'card_type=VISA' \
7. 发起支付请求
商户服务器通过直连模式提交必要参数,并将 Google Pay Payment Token 中的 paymentData.paymentMethodData.tokenizationData.token 对象作为 pay_accountNumber字段的值传入。
cURL -X POST 'https://test-secure.oceanpayment.com/gateway/direct/pay'
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'backUrl=https://www.abc.com/back.php' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=USD' \
-d 'order_amount=0.01' \
-d 'methods=GooglePay' \
-d 'order_notes=' \
-d 'pay_accountNumber={\"signature\":\"MEQCIB...\",\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"...\\\",\\\"ephemeralPublicKey\\\":\\\"...\\\",\\\"tag\\\":\\\"...\\\"}\"}' \
-d 'card_type=VISA' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=US' \
-d 'billing_state=AL' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \
快捷支付
将 Payment Token 作为 pay_accountNumber 参数传递给 Oceanpayment,即可通过 QuickPay 直连接口创建订阅快捷支付。
响应
- 从支付返回结果中获取
pay_url字段,并据此判断是否需要进行 3D 验证。查看完整的响应参数。
- Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<notice_type>transaction</notice_type>
<push_dateTime>2025-12-19 09:52:47</push_dateTime>
<account>995149</account>
<terminal>99514901</terminal>
<signValue>D6315600AE0002C1468DC9B943E17E90B314E73581393ABC332B92985E41B100</signValue>
<methods>GooglePay</methods>
<order_number>NO12345678</order_number>
<card_country>PL</card_country>
<order_currency>USD</order_currency>
<order_amount>0.01</order_amount>
<order_notes></order_notes>
<card_number>411111***1111</card_number>
<card_type>Visa</card_type>
<payment_country></payment_country>
<payment_id>231219095247018026021</payment_id>
<payment_authType>3</payment_authType>
<payment_status>-1</payment_status>
<payment_details>80093:3D Authorized Service not completed</payment_details>
<payment_solutions></payment_solutions>
<payment_risk></payment_risk>
<payment_amount></payment_amount>
<payment_exchangeRate></payment_exchangeRate>
<auth_reason></auth_reason>
<auth_code></auth_code>
<pay_userId></pay_userId>
<pay_url></pay_url>
</response>
- 如果 xml->
pay_url字段为空,无3D 验证环节,则 xml 就是返回的支付结果。此时会触发noticeUrl异步通知。 - 如果 xml->
pay_url字段不为空,有3D 验证环节,需要重定向打开pay_url完成3D 校验,此时支付返回结果会再次发送至backUrl,默认用$_POST 接收返回。此时也会触发noticeUrl异步通知。- 商户将用户重定向到
pay_url:
- 商户将用户重定向到
HTTP/1.2 301 Moved Permanently
Location: {pay_url}
付款状态
查看详细的付款状态说明。
异步通知
您还需要通过noticeUrl接收交易的异步通知。
签名
查看详细的签名和验签功能。