Payment methods

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

创建支付方式接口

POST//unknown/V2022-03/payment_methods

Header parameters

Body

支付方式对象

billingDetail*BillingDetail

card*Card

customerIdstring(100)

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

Example: "cus_1420997690607206400"

Response

Body

codestring

返回码

Example: "success"

messagestring

返回信息

Example: "message response"

dataPaymentMethodResp

Request

const response = await fetch('//unknown/V2022-03/payment_methods', {
    method: 'POST',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "billingDetail": {
        "email": "abc@mail.com",
        "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": "abc@mail.com",
      "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": "indubio@gmail.com",
        "firstName": "Di Mo",
        "lastName": "Shi",
        "phone": "509-675-8948"
    },
    "card": {
        "cardNo": "5333302221254276",
        "cardExpireMonth": "12",
        "cardExpireYear": "2025",
        "cardSecurityCode": "123"
    },
    "customerId": "cus_1526760517237616640"
}'

更新PaymentMethod的信息

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

Header parameters

Body

支付方式对象

billingDetail*BillingDetail

card*Card

customerPaymentMethodId*string(100)

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

Example: "pm_1420997693836820480"

Response

Body

codestring

返回码

Example: "success"

messagestring

返回信息

Example: "message response"

dataPaymentMethodResp

Request

const response = await fetch('//unknown/V2022-03/payment_methods/update', {
    method: 'POST',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "billingDetail": {
        "email": "abc@mail.com",
        "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": "abc@mail.com",
      "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": "indubio@gmail.com",
        "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

Body

codestring

返回码

Example: "success"

messagestring

返回信息

Example: "message response"

dataPaymentMethodResp

Request

const response = await fetch('//unknown/V2022-03/payment_methods/{customerPaymentMethodId}', {
    method: 'GET',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text"
    },
});
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": "abc@mail.com",
      "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

Body

codestring

返回码

Example: "success"

messagestring

返回信息

Example: "message response"

dataarray of PaymentMethodResp

返回数据

Request

const response = await fetch('//unknown/V2022-03/payment_methods/list/{customerId}', {
    method: 'GET',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text"
    },
});
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": "abc@mail.com",
        "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

Body

codestring

返回码

Example: "success"

messagestring

返回信息

Example: "message response"

dataPaymentMethodResp

Request

const response = await fetch('//unknown/V2022-03/payment_methods/{customerPaymentMethodId}/{customerId}/attach', {
    method: 'GET',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text"
    },
});
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": "abc@mail.com",
      "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

Body

codestring

返回码

Example: "success"

messagestring

返回信息

Example: "message response"

dataPaymentMethodResp

Request

const response = await fetch('//unknown/V2022-03/payment_methods/{customerPaymentMethodId}/detach', {
    method: 'GET',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text"
    },
});
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": "abc@mail.com",
      "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

对象

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

Previouscustomer NextConfirm charge

Last updated 8 months ago