邮政编码
| > \* 首次保存卡片时需要填写。 * 如果`id`存在，Codapay 会尝试检索与该关联的现有购物者`shopper_id`。 * 如果`id`未提供，则会创建一个新的购物者并将其与提供的购物者关联`partnerShopperId`。 * 除了此处记录的标准字段外，此处列出的字段也是必填[项](https://coda-payments.gitbook.io/coda-public-technical-documentation/codapay/hosted-payment-page-integration/initiate-a-payment-request#request-parameters)。 有关使用此结构的请求有效负载，请参阅下面的“场景和示例”部分。 #### 场景和示例 本节概述了集成卡片保存功能时最常见的几种用例。每种用例都包含所需的参数和示例请求格式。 1. [首次用户 - 保存卡片选项](https://coda-payments.gitbook.io/coda-public-technical-documentation/codapay/hosted-component-integration/cards/saving-card-details#id-1.-first-time-user-save-card-option) 2. [老用户 – 显示已保存的卡片](https://coda-payments.gitbook.io/coda-public-technical-documentation/codapay/hosted-component-integration/cards/saving-card-details#id-2.-returning-user-show-saved-cards) 3. [老用户 - 无需用户界面即可使用已保存的银行卡付款](https://coda-payments.gitbook.io/coda-public-technical-documentation/codapay/hosted-component-integration/cards/saving-card-details#id-3.-returning-user-charge-saved-card-without-ui) 4. [商户发起的付款 - 用户不在场](https://coda-payments.gitbook.io/coda-public-technical-documentation/codapay/hosted-component-integration/cards/saving-card-details#id-4.-merchant-initiated-payment-user-not-present) **1. 首次用户 – 保存卡片选项** 允许用户在结账时保存他们的银行卡信息。
**要求**
```
{
"initRequest": {
"country": 360,
"payType": 400,
"apiKey": "",
"projectId": "31",
"orderId": "20250611113402",
"currency": 360,
"items": [
{
"code": "12ds",
"price": 10000.00,
"name": "Star Diamond"
}
],
"profile": {
"entry": [
{
"key": "user_id",
"value": "105"
}
]
},
"enableSavePaymentMethod": true,
"displaySavedPaymentMethodList": true,
"userInitiated": true,
"shopper": {
"entry": [
{
"key": "partnerShopperId",
"value": "test_partner_123_Id"
},
{
"key": "email",
"value": "test@example.com"
}
]
}
}
}
```
**回复**
```
{
"initResult": {
"resultCode": 0,
"txnId": 7503012627171645973
}
}
```
**商户通知**
```
{
"eventType": "PAYMENT_METHOD_ADDED",
"timestamp": "2025-06-19T02:48:39.568907Z",
"shopper": {
"id": "shp_sg197861636b40021",
"partner_shopper_id": "test_partner_123_Id",
"email": "test@example.com"
},
"paymentMethod": {
"id": "pmt_sg1978616a1900024",
"type": "card",
"card": {
"lastFour": "7263",
"expirationMonth": "04",
"expirationYear": "2027"
}
}
}
```
**2. 老用户 – 显示已保存的卡片**
显示之前保存的卡片供用户选择。
**要求**
```
{
"initRequest": {
"country": 360,
"payType": 400,
"apiKey": "",
"projectId": "31",
"orderId": "20250611113402",
"currency": 360,
"items": [
{
"code": "12ds",
"price": 10000.00,
"name": "Star Diamond"
}
],
"profile": {
"entry": [
{
"key": "user_id",
"value": "105"
}
]
},
"enableSavePaymentMethod": true,
"displaySavedPaymentMethodList": true,
"userInitiated": true,
"shopper": {
"entry": [
{
"key": "id",
"value": "shp_sg197861636b40021"
}
]
}
}
}
```
**回复**
```
{
"initResult": {
"resultCode": 0,
"txnId": 7503016855911597963
}
}
```
**3.【即将推出】老用户 – 无需用户界面即可使用已保存的银行卡付款**
**要求**
```
{
"initRequest": {
"country": 360,
"payType": 400,
"apiKey": "",
"projectId": "31",
"orderId": "20250611113402",
"currency": 360,
"items": [
{
"code": "12ds",
"price": 10000.00,
"name": "Star Diamond"
}
],
"profile": {
"entry": [
{
"key": "user_id",
"value": "105"
}
]
},
"enableSavePaymentMethod": true,
"displaySavedPaymentMethodList": false,
"userInitiated": true,
"shopper": {
"entry": [
{
"key": "id",
"value": "shp_sg197861636b40021"
}
]
}
}
}
```
**回复**
```
{
"initResult": {
"resultCode": 0,
"txnId": 7503016855911597963
}
}
```
**4. \[即将推出] 商户发起支付 - 用户不在场**
**要求**
```
{
"initRequest": {
"country": 360,
"payType": 400,
"apiKey": "",
"projectId": "31",
"orderId": "20250611113402",
"currency": 360,
"items": [
{
"code": "12ds",
"price": 10000.00,
"name": "Star Diamond"
}
],
"profile": {
"entry": [
{
"key": "user_id",
"value": "105"
}
]
},
"enableSavePaymentMethod": true,
"displaySavedPaymentMethodList": false,
"userInitiated": false,
"shopper": {
"entry": [
{
"key": "id",
"value": "shp_sg197861636b40021"
}
]
}
}
}
```
**回复**
```
{
"initResult": {
"resultCode": 0,
"txnId": 7503016855911597963
}
}
```
[