본문으로 건너뛰기

매입

매입을 실행합니다. 결제 승인과 매입을 분리한 상태에서 결제를 요청한 후 가맹점이 이 API를 호출해 매입을 실행해야 결제가 완료됩니다.

POST /v2/payments/orders/{orderId}/capture

매입 금액은 결제를 요청할 때 입력했던 결제 금액과 달라질 수 있습니다.

Read 타임아웃은 최소 20초 이상으로 설정하세요.

Path

Name
LengthDescription
Required
orderId100

주문 번호. 가맹점에서 주문을 관리하기 위해 생성한 ID를 입력하세요. 입력할 때 URL 인코딩을 적용하세요.

Query

None

Body

Name
TypeLengthDescription
Required
amountnumber

결제 금액

currencystring3

결제 통화 코드(ISO 4217). 지원하는 통화 코드는 다음과 같습니다.

  • "USD"
  • "TWD"
  • "THB"
promotionRestrictionobject

프로모션 제한 정보. 법, 규칙 등에 따라 프로모션 적용 불가한 상품의 금액을 입력하세요.

Headers
  • Content-Type
  • X-LINE-ChannelId
  • X-LINE-ChannelSecret
  • X-LINE-MerchantDeviceProfileId
  • X-LINE-MerchantDeviceType

자세한 내용은 요청 헤더를 참고하세요.

Request examples

curl -X POST \
     -H "Content-Type: application/json" \
     -H "X-LINE-ChannelId: YOUR_CHANNEL_ID" \
     -H "X-LINE-ChannelSecret: YOUR_CHANNEL_SECRET" \
     -H "X-LINE-MerchantDeviceProfileId: YOUR_DEVICE_PROFILE_ID" \
     -d '{
          "amount": 100,
          "currency": "THB",
          "extras": {
            "promotionRestriction": {
              "useLimit": 20,
              "rewardLimit": 20
            }
          }' \
      https://sandbox-api-pay.line.me/v2/payments/orders/merchant_test_order_1/capture