# Payment methods {% openapi src="" path="/V2022-03/payment\_methods" method="post" %} [gitbook .json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2FaSm0HICLvmjsHIG0gPX6%2Fgitbook%20.json?alt=media\&token=02baaaa5-1304-46b3-bba2-4dbae43ffa30) {% endopenapi %} ### 创建支付方式接口请求报文示例 {% code title="createPaymentMethod.sh" %} ``` curl --request POST \ --url https://{paymentApiUrl}/V2022-03/payment_methods \ --header 'Content-Type: application/json' \ --header 'request-id: 58675' \ --header 'request-time: 1651888520935' \ --header 'gateway-no: 12345001' \ --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \ --data '{ "billingDetail": { "address": { "city": "NEWARK VALLEY", "country": "US", "line1": "4348 Calico Drive", "postalCode": "13811", "state": "NY" }, "email": "indubio@gmail.com", "firstName": "Di Mo", "lastName": "Shi", "phone": "509-675-8948" }, "card": { "cardNo": "5333302221254276", "cardExpireMonth": "12", "cardExpireYear": "2025", "cardSecurityCode": "123" }, "customerId": "cus_1526760517237616640" }' ``` {% endcode %} {% openapi src="" path="/V2022-03/payment\_methods/update" method="post" %} [gitbook .json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2FaSm0HICLvmjsHIG0gPX6%2Fgitbook%20.json?alt=media\&token=02baaaa5-1304-46b3-bba2-4dbae43ffa30) {% endopenapi %} ### 更新支付方式接口请求报文示例 {% code title="updatePaymentMethod.sh" %} ``` curl --request POST \ --url https://{paymentApiUrl}/V2022-03/payment_methods/update \ --header 'Content-Type: application/json' \ --header 'request-id: 58675' \ --header 'request-time: 1651888520935' \ --header 'gateway-no: 12345001' \ --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \ --data '{ "billingDetail": { "address": { "city": "NEWARK VALLEY", "country": "US", "line1": "4349 Calico Drive", "postalCode": "13811", "state": "NY" }, "email": "indubio@gmail.com", "firstName": "Di Ma", "lastName": "Shi", "phone": "509-675-8948" }, "customerPaymentMethodId": "pm_1526760521989763072" }' ``` {% endcode %} ### 获取支付方式接口请求报文示例 ``` curl --request GET \ --url https://{paymentApiUrl}/V2022-03/payment_methods/pm_1526760521989763072 \ --header 'Content-Type: application/json' \ --header 'request-id: 58675' \ --header 'request-time: 1651888520935' \ --header 'gateway-no: 12345001' \ --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \ ``` {% openapi src="" path="/V2022-03/payment\_methods/{customerPaymentMethodId}" method="get" %} [gitbook .json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2FaSm0HICLvmjsHIG0gPX6%2Fgitbook%20.json?alt=media\&token=02baaaa5-1304-46b3-bba2-4dbae43ffa30) {% endopenapi %} ### 获取支付方式接口请求报文示例 {% code title="getPaymentMethod" %} ``` curl --request GET \ --url https://{paymentApiUrl}/V2022-03/payment_methods/pm_1526760521989763072 \ --header 'Content-Type: application/json' \ --header 'request-id: 58675' \ --header 'request-time: 1651888520935' \ --header 'gateway-no: 12345001' \ --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \ ``` {% endcode %} {% openapi src="" path="/V2022-03/payment\_methods/list/{customerId}" method="get" %} [gitbook .json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2FaSm0HICLvmjsHIG0gPX6%2Fgitbook%20.json?alt=media\&token=02baaaa5-1304-46b3-bba2-4dbae43ffa30) {% endopenapi %} ### 根据客户获取所有支付方式接口请求报文示例 {% code title="getPaymentMethodListByCustomerId.sh" %} ``` curl --request GET \ --url https://{paymentApiUrl}/V2022-03/payment_methods/list/cus_1526760517237616640 \ --header 'Content-Type: application/json' \ --header 'request-id: 58675' \ --header 'request-time: 1651888520935' \ --header 'gateway-no: 12345001' \ --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \ ``` {% endcode %} {% openapi src="" path="/V2022-03/payment\_methods/{customerPaymentMethodId}/{customerId}/attach" method="get" %} [gitbook .json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2FaSm0HICLvmjsHIG0gPX6%2Fgitbook%20.json?alt=media\&token=02baaaa5-1304-46b3-bba2-4dbae43ffa30) {% endopenapi %} ### 客户附加支付方式接口请求报文示例 ``` curl --request GET \ --url https://{paymentApiUrl}/V2022-03/payment_methods/pm_1526760521989763072/cus_1526760517237616640/attach \ --header 'Content-Type: application/json' \ --header 'request-id: 58675' \ --header 'request-time: 1651888520935' \ --header 'gateway-no: 12345001' \ --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \ ``` {% openapi src="" path="/V2022-03/payment\_methods/{customerPaymentMethodId}/detach" method="get" %} [gitbook .json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2FaSm0HICLvmjsHIG0gPX6%2Fgitbook%20.json?alt=media\&token=02baaaa5-1304-46b3-bba2-4dbae43ffa30) {% endopenapi %} ### 解绑支付方式接口请求报文示例 ``` curl --request GET \ --url https://{paymentApiUrl}/V2022-03/payment_methods/pm_1526760521989763072/detach \ --header 'Content-Type: application/json' \ --header 'request-id: 58675' \ --header 'request-time: 1651888520935' \ --header 'gateway-no: 12345001' \ --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \ ``` {% hint style="info" %} 以上接口，【根据客户获取所有支付方式】【解绑支付方式】返回结构差异外，其他均返回如下结构（由于数据字段并无差别所以不再展示） {% endhint %} #### 结果对象属性描述
property nametypedescription
codeString返回码
messageString返回信息
dataObject数据对象
customerPaymentMethodIdString

支付方式id；

如：pm_1671231231232

cardObject对象
last4String卡后四位
brandString

卡组织；

如：Visa

billingDetailObject对象
emailString邮箱
firstNameStringfirstName
lastNameStringlastName
phoneString电话
addressObject对象
cityString城市
countryString国家代码，两位字母的ISO国家代码
line1String地址1，该地址优先使用
line2String地址2
postalCodeString邮编
stateString州；两位字母的ISO州代码