建立會員
通過自身顧客資訊開通付款中台付款會員,獲得付款中台會員customerId,用於後續綁定付款工具動作
介面路徑
| 請求方式 | API 路徑 |
|---|---|
| POST | {DOMAIN_NAME} /api/v1/customer/create |
請求電文
Http.header 參數
Content-TypeString必填
固定值:application/json
platformIdString選填
SLP 平台 ID,平台特店必填
merchantIdString必填
直連特店串接:SLP 分配的特店 ID;平台特店串接:SLP 分配的子特店 ID
apiKeyString必填
API 介面金鑰
requestIdString(32)必填
請求流水號,每個 HTTP 請求唯一
idempotentKeyString(32)選填
冪等 KEY
Http.body
referenceCustomerIdString必填
特店會員 ID
customerCustomer必填
顧客資訊
emailString選填
顧客郵箱,郵箱和電話二者需至少傳入其一
phoneNumberString選填
顧客電話,需帶國碼,舉例 +6287654321876,郵箱和電話二者需至少傳入其一
shippingShipping選填
物流訂單資訊, SLP 智慧風控必需
personalInfoPersonalInfo選填
收貨人資訊
firstNameString(64)選填
顧客名字,firstName 和 lastName 加總長度不可超過 128
lastNameString(64)選填
顧客名字,firstName 和 lastName 加總長度不可超過 128
emailString選填
顧客郵箱,郵箱和電話二者需至少傳入其一
phoneNumberString選填
電話號碼
phoneCountryCodeString選填
電話號碼的國家碼
homeTelephoneString選填
家庭電話號碼
identityNumberString選填
身份證件號碼
addressAddress選填
地址,有物流地址的場景下必填
countryCodeString選填
國家/地區二位編碼
stateString選填
州/省(如果沒有,傳遞空字串)
stateCodeString選填
州/省編碼(如果没有,傳遞空字串)
cityString選填
城市
districtString選填
區域
streetString選填
街道
street2String選填
街道2
street3String選填
街道3
postcodeString選填
邮政編碼
shippingMethodString選填
產品物流方式(傳遞運輸方案的值)
carrierString選填
運輸渠道,有則必傳
taxCurrencyAmount選填
郵費稅,有則必傳
valueLong選填
金額,台幣傳金額*100,譬如1元傳入100
currencyString選填
幣種,目前僅支援 TWD
amountCurrencyAmount選填
郵費金額(包含郵費稅),有則必傳
valueLong選填
金額,台幣傳金額*100,譬如1元傳入100
currencyString選填
幣種,目前僅支援 TWD
attachDataMap選填
透傳資訊
nameString選填
姓名
回應電文
處理結果 http.statusCode
* 500 /429 /400:處理異常
* 200:處理成功
customerIdString(32)必填
付款中台會員 ID
referenceCustomerIdString(32)必填
特店會員 ID
attachDataMap選填
透傳資訊