Skip to main content

子特店資料更新

介面路徑​

請求方式API 路徑
POST{DOMAIN_NAME} /api/v1/kyc/merchant/update

請求電文​

Http.header 參數​

Content-TypeString必填
固定值：application/json
platformIdString選填
SLP 平台 ID，平台特店必填
merchantIdString必填
直連特店串接：SLP 分配的特店 ID；平台特店串接：SLP 分配的子特店 ID
apiKeyString必填
API 介面金鑰
requestIdString(32)必填
請求流水號，每個 HTTP 請求唯一
idempotentKeyString(32)選填
冪等 KEY

Http.body​

回應電文​

處理結果 http.statusCode​

* 500 /429 /400：處理異常​

codeString必填
錯誤碼，錯誤碼及錯誤描述詳情查看： Server 錯誤碼
msgString必填
錯誤描述，錯誤碼及錯誤描述詳情查看： Server 錯誤碼

* 200：處理成功​

POST/api/v1/kyc/merchant/update

sandbox api

https://api-sandbox.shoplinepayments.com/api/v1/kyc/merchant/update

live api

https://api.shoplinepayments.com/api/v1/kyc/merchant/update
請求電文範例
{
    "userAccount": {
        "mail": "example@gmail.com"
    },
    "entity": {
        "entityType": "INDIVIDUAL",
        "entitySubType": "PERSON",
        "entityCountry": "TW",
        "individual": {
            "defaultGivenName": "美玲",
            "defaultFamilyName": "陳",
            "secondGivenName": "Mei-Ling",
            "secondFamilyName": "Chen",
            "identities": [
                {
                    "idType": "IDCARD",
                    "idNumber": "A286847906",
                    "documents": [
                        {
                            "documentType": "ID_CARD_FRONT",
                            "name": "身分證正面",
                            "fileId": "7420431912927503524"
                        },
                        {
                            "documentType": "ID_CARD_BACK",
                            "name": "身分證背面",
                            "fileId": "7420431912927503524"
                        }
                    ],
                    "issuerData": {
                        "issuerDate": "2026-12-01",
                        "issuerPlace": "10001",
                        "documentChangeType": "ExchangeCollection"
                    }
                }
            ],
            "dateOfBirth": "2000-01-01",
            "nationality": "TW",
            "gender": "FEMALE",
            "businessAddresses": {
                "countryCode": "TW",
                "cityCode": "1200003",
                "regionCode": "1200042",
                "line1": "台北市信義區信義路五段7號"
            }
        },
        "contact": {
            "phone": {
                "phoneAreaCode": "+886",
                "phoneNumber": "912345678"
            },
            "email": "example@gmail.com",
            "contactName": "陳美玲"
        }
    },
    "operation": {
        "onlineStoreOperation": {
            "onlineStore": {
                "storeName": "美玲美妝生活館",
                "transactionName": "DEMOSTORE",
                "mainSaleType": "BeautyOrcosmetics",
                "saleType": "CosmeticProductStore"
            },
            "domains": [
                {
                    "url": "https://www.example-store.com.tw"
                }
            ],
            "paymentMethod": [
                "VirtualAccount",
                "CreditCard_Normal",
                "CreditCard_Installment",
                "ApplePay",
                "ChaileaseBNPL"
            ]
        },
        "operationCommon": {
            "estimatedTransactionVolume": {
                "amountPreMonth": "LT360000"
            }
        }
    },
    "bank": [
        {
            "nationality": "TW",
            "bankCode": "5210116",
            "branchBank": {
                "branchCode": "1232"
            },
            "accountName": "陳美玲",
            "accountNo": "224669669087",
            "currency": "TWD",
            "documents": [
                {
                    "fileId": "7420431912927503524",
                    "documentType": "BANK_STATEMENT",
                    "name": "銀行帳單"
                }
            ]
        }
    ]
}
回應電文範例
{}