매입

매입을 실행합니다. 결제 승인과 매입을 분리해 구현했다면 결제를 승인한 후 가맹점이 이 API를 호출해 매입을 실행해야 결제가 완료됩니다.

POST /v3/payments/authorizations/{transactionId}/capture

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

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

Request

Response

Path

Name	Description	Required
`transactionId`	결제 트랜잭션 ID. 자세한 설명은 트랜잭션 ID를 참고하세요.

Query

None

Body

Name	Type	Description	Required
`amount`	number	결제 금액
`currency`	string	결제 통화 코드(ISO 4217). 지원하는 통화 코드는 다음과 같습니다. `"USD"` `"TWD"` `"THB"`

Name

Type

Description

Required

amount

number

결제 금액

currency

string

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

"USD"
"TWD"
"THB"

Headers

Content-Type
X-LINE-Authorization
X-LINE-Authorization-Nonce
X-LINE-ChannelId
X-LINE-MerchantDeviceProfileId

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

Request examples

bash

curl -X POST \
     -H "Content-Type: application/json" \
     -H "X-LINE-ChannelId: YOUR_CHANNEL_ID" \
     -H "X-LINE-Authorization-Nonce: GENERATED_NONCE" \
     -H "X-LINE-Authorization: PROCESSED_SIGNATURE" \
     -H "X-LINE-MerchantDeviceProfileId: YOUR_DEVICE_PROFILE_ID" \
     -d '{
           "amount": 1000,
           "currency": "TWD"
         }' \
     https://sandbox-api-pay.line.me/v3/payments/authorizations/2018082512345678910/capture

Name	Type	Description
`info`	Object	결과 정보
`returnCode`	String	결과 코드. API 호출 성공 시 `0000` 값이 반환됩니다. 그 외 결과 코드는 오류 코드이며, `1199`, `1280`-`1298` 코드가 반환되면 결제는 자동 취소됩니다. 자세한 내용은 결과 코드를 참고하세요.
`returnMessage`	String	결과 메시지. 결과 메시지는 결과 코드를 참고하세요.