본문으로 건너뛰기

결제 요청

입력된 결제 정보를 이용해 LINE Pay 서버에 결제를 요청합니다. 결제 정보에는 고객이 결제할 주문 정보와 결제 수단을 설정하세요. 결제 요청이 문제 없이 처리되면 고객은 LINE Pay 인증 화면으로 이동합니다.

또한, 이 API의 응답으로 트랜잭션 ID가 발급되는데 이를 이용해 결제 승인과 승인 취소, 매입, 환불을 요청할 수 있습니다.

POST /v3/payments/request

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

Path

None

Query

None

Body

Name
TypeLengthDescription
Required
amountnumber

결제 금액. 전체 상품 패키지의 구매 금액(packages[].amount)와 수수료(packages[].userFee)를 모두 합한 금액입니다.

currencystring3

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

  • "USD"
  • "TWD"
  • "THB"
optionsobject

결제 요청 설정 정보

orderIdstring100

주문 번호. 가맹점에서 주문을 관리하기 위해 생성한 ID를 입력하세요.

packages[]object array

배송 단위 또는 점포 단위로 구분한 상품 패키지 정보

redirectUrlsobject

결제 요청 후처리용 리다이렉션 URL 정보

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

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

Request examples

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" : 100,
          "currency" : "TWD",
          "orderId" : "MKSI_S_20180904_1000001",
          "packages" : [
            {
              "id" : "1",
              "amount": 100,
              "products" : [
                {
                  "id" : "PEN-B-001",
                  "name" : "Pen Brown",
                  "imageUrl" : "https://pay-store.example.com/images/pen_brown.jpg",
                  "quantity" : 2,
                  "price" : 50
                }
              ]
            }
          ],
          "redirectUrls" : {
            "confirmUrl" : "https://pay-store.example.com/order/payment/authorize",
            "cancelUrl" : "https://pay-store.example.com/order/payment/cancel"
          }
        }'
     https://sandbox-api-pay.line.me/v3/payments/request