자동 결제 요청

발급한 자동 결제용 키를 이용해 LINE Pay 서버에 자동 결제를 요청합니다.

POST /v3/payments/preapprovedPay/{regKey}/payment

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

Request

Response

Path

Name	Description	Required
`regKey`	발급된 자동 결제용 키

Query

None

Body

Name	Type	Length	Description
`amount`	number		결제 금액
`capture`	boolean		자동 매입 여부. 자동 결제를 처리할 때 매입을 동시에 처리할지 분리할지 결정합니다. 기본 값은 `true`입니다. `true`: 동시에 처리합니다. `false`: 분리해 처리합니다.
`currency`	string	3	결제 통화 코드(ISO 4217). 지원하는 통화 코드는 다음과 같습니다. `"USD"` `"TWD"` `"THB"`
`orderId`	string	100	주문 번호. 가맹점에서 주문을 관리하기 위해 생성한 ID를 입력하세요.
`productName`	string	4000	상품 이름

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-Authorize-Nonce: 6120489b-53f3-4c51-9d6f-b80be93e509a"\
     -H "X-LINE-Authorization: PROCESSED_SIGNATURE" \
     -H "X-LINE-MerchantDeviceProfileId: YOUR_DEVICE_PROFILE_ID" \
     -d '{
          "productName": "Brown pen",
          "amount": 1000,
          "currency": "TWD",
          "orderId": "Ord2018123100000001"
        }' \
     https://sandbox-api-pay.line.me/v3/payments/preapprovedPay/RK123asd213/payment

Name	Type	Length	Description
`info`	Object		결과 정보
`returnCode`	String	4	결과 코드. API 호출 성공 시 `0000` 코드가 반환됩니다. 그 외 결과 코드는 오류 코드이며, `1141`, `1282`-`1287`, `1290`-`1295` 코드가 반환되면 자동 결제용 키를 만료 처리합니다. 자세한 내용은 결과 코드를 참고하세요.
`returnMessage`	String		결과 메시지. 결과 메시지는 결과 코드를 참고하세요.