멤버십 발급 신청

고객정보를 기준으로 멤버십 발급을 요청합니다.

POST https://api.vircle.co.kr/v1/partner/:partnerId/membership

Path Parameters

Name	Type	Description
partnerId*	String	파트너 ID

Headers

Name	Type	Description
X-Vircle-API-Key*	String	파트너 API Key
Authorization*	String	파트너 API Secret

Request Body

Name	Type	Description
ordererTel*	String(16)	고객 휴대폰번호
ordererName*	String(30)	멤버십을 발급할 고객명
customFields	Object	추가필드 { "필드명1": "데이터", "필드명2": "데이터" }

200: OK 성공

{
  "idx": 6928,
  "status": "발급완료",
  "productName": "프라다 가죽 핸드백1",
  "refUserId": "woody",
  "refOrderId": "202301111550-1",
  "refOrderDetailId": "202301111550-1-2",
  "refProductCode": "P0001",
  "refCategoryCode": "C01",
  "refBrandCode": "B001",
  "registeredAt": "2023-01-16 19:53:02",
  "modifiedAt": null,
  "categoryCode": "1",
  "brandName": "프라다",
  "brandNameEn": "Prada",
  "price": 1250000,
  "modelNumber": "AAA12345",
  "productImages": [
    "https://static.vircle.co.kr/files/product/3888/68257436-b13d-46b9-9f1a-1b5e62db9a9d.jpg"
  ],
  "ordererName": "홍길동",
  "ordererTel": "01000000000",
  "sellerName": "판매자",
  "sellerAuthInfo": "본 판매자는 검증된 업체입니다.",
  "warrantyDate": "보증기간 5년, 가품 판정시 200% 보상",
  "guaranteeToken": "6adbc970ecf40baaa44d4e16b385b737e08f0aed8417e36c5c59e8252df33bd1",
  "nft": {
    "tokenId": 6928,
    "nftCardImg": "https://static.vircle.co.kr/files/nft/card/5105714f-f860-45d3-8846-3a461827876c.png",
    "externalLink": "https://app.vircle.co.kr/card/3888",
    "transactionHash": "0x46410186da41a0e7a9d8efad0d0d3656401cef9f85dbe55c4235af7c003b6cc7",
    "issuedAt": "2023-01-16 19:53:06"
  },
  "inspections": null
}

400: Bad Request 필수값 누락

{
    "code": "BAD_REQUEST_ERROR",
    "message": "요청 파라미터가 유효하지 않습니다. 세부 에러항목을 확인해주세요.",
    "errors": [
        {
            "value": "",
            "property": "productName",
            "children": [],
            "constraints": {
                "isNotEmpty": "productName should not be empty"
            }
        }
    ]
}