상품 주문

트레져러 연동 웹뷰가 아닌 파트너사 앱 또는 웹에서 직접 상품을 구매할 수 있는 기능을 제공하기 위한 API입니다. 공개 API와는 달리 Header -> Authorization에 파트너사와 사전 제공된 API_KEY를 통한 인증이 필요합니다.

사용 가이드

Headers

Name	Value
Content-Type	application/json
Authorization	${PARTNER_NAME} ${API_KEY}

주문서 발행

POST /v1/partners/order/purchase

실제 구매 체결 요청 전, 시장가 구매에 따른 예상 체결 내역을 확인할 수 있는 API입니다.

• 파트너키와 주문정보를 기반으로 주문서를 발행합니다.

• 실제 트랜잭션이 발생하지 않는 조회용 API입니다.

Body (Example)

{
  "partnerKey": "abc-123-def-456", // [Required] 회원가입 시 발급된 파트너키
  "transactionMethod": "OPEN_ITEM", // [Required] 주문 방법, "OPEN_ITEM"(금 구매, 시장가) | "SINGLE_PRICE"(명품 구매, 단일가)
  "tradeBasis": "AMOUNT", // [Required] 주문서 거래 방법 종류, "AMOUNT"(금 구매, 금액) | "QUNATITY"(명품 구매, 수량)
  "platform": "MYB", // [Required] 파트너사 종류, "MYB" | "LPOINT" | "SYRUP" | "KB"
  "tradeItemId": 1001, // [Required] 상품 ID, 금은 1001
  "amount": 1500, // [Optional] tradeBasis에 따른 총 구매 금액
  "qunatity": 0, // [Optional] tradeBasis에 따른 총 구매 수량
  "paymentInfo": { // [Required] 결제 내역 정보
    "mybPoint": 1500 // [Optional] 마이비 포인트 사용 시 포함
    "krw": 0, // [Optional] 트레져러 예치금 사용 시 포함
    "treasurerPoint": 0 // [Optional] 트레져러 포인트 사용 시 포함
  }
}

Response (Example)

{
  "result": "success",
  "message": "success",
  "code": 200,
  "data": {
    "aggregatedPrice": 991, // 총 결제 예상 금액(체결금액 + 수수료)
    "aggregatedQuantity": 69, // 총 체결 예상 수량
    "aggregatedWeight": 0.0069, // 총 체결 예상 무게(금/은)
    "aggregatedFee": 7, // 총 발생 수수료
    "paymentList": [
      {
        "system": "MYBPOINT", // 결제 플랫폼
        "provider": "MYB", // 결제 제공사
        "amount": 991, // 원화 기준 총 결제 예상 금액
        "usePointAmount": 1487, // 결제 플랫폼 기준 총 결제 예상 금액(포인트)
        "fee": 7 // 결제 플랫폼별 수수료
      },
      {
        "system": "KRW", // 결제 플랫폼(KRW = 트레져러 예치금)
        "provider": "TREASURER", // 결제 제공사
        "amount": 0, // 원화 기준 총 결제 예상 금액
        "usePointAmount": 0, // 결제 플랫폼 기준 총 결제 예상 금액
        "fee": 0 // 결제 플랫폼별 수수료
      }
    ]
  }
}

주문 체결

POST /v1/partners/purchase

실제 주문 체결을 요청하는 API입니다.

• 요청 바디는 주문서 발행과 동일한 포맷을 사용합니다.

• 실제 체결된 주문 내역을 반환합니다.

Body (Example)

• 주문서 발행 요청 body와 동일

Response (Example)

{
  "result": "success",
  "message": "success",
  "code": 200,
  "data": {
    "tradeItemId": 1001, // 체결된 상품 ID
    "transactionId": 155758, // 주문 체결 내역 ID
    "ownershipId": 48228, // 유저의 소유권 ID
    "quantity": 70, // 체결 수량
    "fee": 7, // 총 수수료
    "amount": 991, // 원화 기준 총 결제 금액
    "paymentInfo": { // 결제 내역
      "mybPoint": -1487 // MYB 포인트 사용량
    }
  }
}