Payment methods

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

创建支付方式接口

创建支付方式接口

POST//unknown/V2022-03/payment_methods

Header parameters

Body

application/json

支付方式对象

billingDetail*BillingDetail

card*Card

customerIdstring(100)

客户ID； 将客户与创建的支付方式进行绑定； 商户可以通过接口/customers发起post创建； 最大长度为100； 如：cus_1420997690607206400

Response

200

OK

Body

*/*response body

codestring

返回码

messagestring

返回信息

dataPaymentMethodResp

Request

JavaScriptCurl

const response = await fetch('//unknown/V2022-03/payment_methods', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "billingDetail": {
        "email": "[e-mail]",
        "firstName": "asia",
        "lastName": "bill",
        "phone": 13212344321
      },
      "card": {}
    }),
});
const data = await response.json();

Response

{
  "code": "success",
  "message": "message response",
  "data": {
    "billingDetail": {
      "Address": {
        "city": "Maryland",
        "country": "US",
        "line1": "west street",
        "postalCode": "21133",
        "state": "MD"
      },
      "email": "[e-mail]",
      "firstName": "asia",
      "lastName": "bill",
      "phone": 13212344321
    },
    "card": {
      "brand": 2222,
      "last4": 1111
    },
    "customerPaymentMethodId": "pm_1420997693836820480"
  }
}

创建支付方式接口请求报文示例

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": "[e-mail]",
        "firstName": "Di Mo",
        "lastName": "Shi",
        "phone": "509-675-8948"
    },
    "card": {
        "cardNo": "5333302221254276",
        "cardExpireMonth": "12",
        "cardExpireYear": "2025",
        "cardSecurityCode": "123"
    },
    "customerId": "cus_1526760517237616640"
}'

更新PaymentMethod的信息

更新PaymentMethod的信息

POST//unknown/V2022-03/payment_methods/update

Header parameters

Body

application/json

支付方式对象

billingDetail*BillingDetail

card*Card

customerPaymentMethodId*string(100)

卡支付ID， 商户可以通过接口/payment_methods发起post创建，必填项； 如：pm_1420997693836820480

Response

200

OK

Body

*/*response body

codestring

返回码

messagestring

返回信息

dataPaymentMethodResp

Request

JavaScriptCurl

const response = await fetch('//unknown/V2022-03/payment_methods/update', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "billingDetail": {
        "email": "[e-mail]",
        "firstName": "asia",
        "lastName": "bill",
        "phone": 13212344321
      },
      "card": {},
      "customerPaymentMethodId": "pm_1420997693836820480"
    }),
});
const data = await response.json();

Response

{
  "code": "success",
  "message": "message response",
  "data": {
    "billingDetail": {
      "Address": {
        "city": "Maryland",
        "country": "US",
        "line1": "west street",
        "postalCode": "21133",
        "state": "MD"
      },
      "email": "[e-mail]",
      "firstName": "asia",
      "lastName": "bill",
      "phone": 13212344321
    },
    "card": {
      "brand": 2222,
      "last4": 1111
    },
    "customerPaymentMethodId": "pm_1420997693836820480"
  }
}

更新支付方式接口请求报文示例

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": "[e-mail]",
        "firstName": "Di Ma",
        "lastName": "Shi",
        "phone": "509-675-8948"
    },
    "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//unknown/V2022-03/payment_methods/{customerPaymentMethodId}

Path parameters

customerPaymentMethodId*string

卡支付ID，最大长度100，如：pm_1420997693836820480

Header parameters

Response

200

OK

Body

*/*response body

codestring

返回码

messagestring

返回信息

dataPaymentMethodResp

Request

JavaScriptCurl

const response = await fetch('//unknown/V2022-03/payment_methods/{customerPaymentMethodId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "success",
  "message": "message response",
  "data": {
    "billingDetail": {
      "Address": {
        "city": "Maryland",
        "country": "US",
        "line1": "west street",
        "postalCode": "21133",
        "state": "MD"
      },
      "email": "[e-mail]",
      "firstName": "asia",
      "lastName": "bill",
      "phone": 13212344321
    },
    "card": {
      "brand": 2222,
      "last4": 1111
    },
    "customerPaymentMethodId": "pm_1420997693836820480"
  }
}

获取支付方式接口请求报文示例

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//unknown/V2022-03/payment_methods/list/{customerId}

Path parameters

customerId*string

客户id，最大长度100，如：cus_1420997690607206400

Header parameters

Response

200

OK

Body

*/*response body

codestring

返回码

messagestring

返回信息

dataarray of PaymentMethodResp

返回数据

Request

JavaScriptCurl

const response = await fetch('//unknown/V2022-03/payment_methods/list/{customerId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "success",
  "message": "message response",
  "data": [
    {
      "billingDetail": {
        "Address": {
          "city": "Maryland",
          "country": "US",
          "line1": "west street",
          "postalCode": "21133",
          "state": "MD"
        },
        "email": "[e-mail]",
        "firstName": "asia",
        "lastName": "bill",
        "phone": 13212344321
      },
      "card": {
        "brand": 2222,
        "last4": 1111
      },
      "customerPaymentMethodId": "pm_1420997693836820480"
    }
  ]
}

根据客户获取所有支付方式接口请求报文示例

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//unknown/V2022-03/payment_methods/{customerPaymentMethodId}/{customerId}/attach

Path parameters

customerId*string

客户id，最大长度100，如：cus_1420997690607206400

customerPaymentMethodId*string

卡支付ID，最大长度100，如：pm_1420997693836820480

Header parameters

Response

200

OK

Body

*/*response body

codestring

返回码

messagestring

返回信息

dataPaymentMethodResp

Request

JavaScriptCurl

const response = await fetch('//unknown/V2022-03/payment_methods/{customerPaymentMethodId}/{customerId}/attach', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "success",
  "message": "message response",
  "data": {
    "billingDetail": {
      "Address": {
        "city": "Maryland",
        "country": "US",
        "line1": "west street",
        "postalCode": "21133",
        "state": "MD"
      },
      "email": "[e-mail]",
      "firstName": "asia",
      "lastName": "bill",
      "phone": 13212344321
    },
    "card": {
      "brand": 2222,
      "last4": 1111
    },
    "customerPaymentMethodId": "pm_1420997693836820480"
  }
}

客户附加支付方式接口请求报文示例

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//unknown/V2022-03/payment_methods/{customerPaymentMethodId}/detach

Path parameters

customerPaymentMethodId*string

卡支付ID，最大长度100，如：pm_1420997693836820480

Header parameters

Response

200

OK

Body

*/*response body

codestring

返回码

messagestring

返回信息

dataPaymentMethodResp

Request

JavaScriptCurl

const response = await fetch('//unknown/V2022-03/payment_methods/{customerPaymentMethodId}/detach', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "code": "success",
  "message": "message response",
  "data": {
    "billingDetail": {
      "Address": {
        "city": "Maryland",
        "country": "US",
        "line1": "west street",
        "postalCode": "21133",
        "state": "MD"
      },
      "email": "[e-mail]",
      "firstName": "asia",
      "lastName": "bill",
      "phone": 13212344321
    },
    "card": {
      "brand": 2222,
      "last4": 1111
    },
    "customerPaymentMethodId": "pm_1420997693836820480"
  }
}

解绑支付方式接口请求报文示例

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州代码