Payment methods

Search…

Payment methods

创建支付方式以及客户信息，并作关联操作

post
https://{paymentApiUrl}
/V2022-03/payment_methods
创建支付方式接口
创建支付方式接口请求报文示例
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": "NXNCVMOS",
            "country": "CA",
            "line1": "ceshi",
            "postalCode": "226085",
            "state": "MD"
        },
        "email": "[email protected]",
        "firstName": "Fsjpfz",
        "lastName": "LSulzfb",
        "phone": "183330173160"
    },
    "card": {cc
        "cardNo": "5333302221254276",
        "cardExpireMonth": "12",
        "cardExpireYear": "2025",
        "cardSecurityCode": "123",
    },
    "customerId": "cus_1526760517237616640"
}'
post
https://{paymentApiUrl}
/V2022-03/payment_methods/update
更新PaymentMethod的信息
更新支付方式接口请求报文示例
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": "NXNCVMOS",
            "country": "CA",
            "line1": "ceshi",
            "postalCode": "226085",
            "state": "MD"
        },
        "email": "[email protected]",
        "firstName": "Fsjpfz",
        "lastName": "LSulzfb",
        "phone": "183330173160"
    },
    "card": {
        "cardNo": "5333302221254276",
        "cardExpireMonth": "12",
        "cardExpireYear": "2025",
        "cardSecurityCode": "123",
    },
    "customerPaymentMethodId": "pm_1526760521989763072"
}'
获取支付方式接口请求报文示例
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' \
get
https://{paymentApiUrl}
/V2022-03/payment_methods/{customerPaymentMethodId}
获取支付方式接口
获取支付方式接口请求报文示例
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' \
get
https://{paymentApiUrl}
/V2022-03/payment_methods/list/{customerId}
根据客户获取所有支付方式接口
根据客户获取所有支付方式接口请求报文示例
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' \
get
https://{paymentApiUrl}
/V2022-03/payment_methods/{customerPaymentMethodId}/{customerId}/attach
客户附加支付方式接口
客户附加支付方式接口请求报文示例
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' \
get
https://{paymentApiUrl}
/V2022-03/payment_methods/{customerPaymentMethodId}/detach
解绑支付方式接口
解绑支付方式接口请求报文示例
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' \
以上接口，【根据客户获取所有支付方式】【解绑支付方式】返回结构差异外，其他均返回如下结构（由于数据字段并无差别所以不再展示）
结果对象属性描述
property name
type
description
code
String
返回码
message
String
返回信息
data
Object
数据对象
    customerPaymentMethodId
String
支付方式id；
如：pm_1671231231232
    card
Object
对象
        last4
String
卡后四位
        brand
String
卡组织；
如：Visa
    billingDetail
Object
对象
        email
String
邮箱
        firstName
String
firstName
        lastName
String
lastName
        phone
String
电话
        address
Object
对象
            city
String
城市
            country
String
国家代码，两位字母的ISO国家代码
            line1
String
地址1，该地址优先使用
            line2
String
地址2
            postalCode
String
邮编
            state
String
州；两位字母的ISO州代码