EBP V2 API Docs v0.5.21
KR

구매 API - 결제 의사 생성 #

1. API 개요 #

용도 #

이 API는 결제 프로세스를 시작하기 위해 결제 의사(Payment Intent)를 초기화합니다. 카드, 계좌 이체, 할부, 전자 지갑을 포함한 다양한 결제 수단을 지원합니다. 결제 관련 UI 제공이 필요한 경우에는 EBP에서 제공하는 ebp-sdk.js를 필수로 사용하여 연동해야 합니다. 결제 의사 생성 후 결제 처리가 진행되면, EBP는 결과를 수신하여 웹훅을 전송하거나 가맹점의 결제 생성 API 호출을 통해 거래를 최종 완료합니다.

상세 정보 #

항목값
API 명칭결제 의사 생성
API 경로/api/v2/payment-intents
API IDEBP_API_224
HTTP 메서드POST
지역Global

[!INFO] 빌링 계정 생성 시점
빌링 계정은 별도의 가입 절차 없이, 사용자가 최초로 토큰을 등록하거나 결제를 요청할 때 전달된 스토어 ID(X-Store-Id)와 사용자 번호(userNo)를 기준으로 시스템에 자동 생성됩니다.

결제 의사를 생성한 후, 사용자가 결제 수단을 통해 인증을 완료하면 EBP는 결과를 알리기 위해 상점으로 웹훅을 전송합니다.
웹훅에 대한 상세 문서는 아래 링크에서 확인할 수 있습니다.
결제 승인 완료 웹훅 바로가기

2. 요청 사양 #

2.1 요청 헤더 #

상세한 헤더 정보는 Common Headers 문서를 참고하세요.

depth필드상세 및 설명
0X-Idempotency-Key

string

🔴 Required

동일한 결제 의사 생성 요청에 대한 중복 처리를 방지하기 위한 멱등성 키입니다.

2.2 요청 데이터 스키마 #

depth필드상세 및 설명
0userNo

string

🔴 Required

사용자 번호

0userName

string

🟡 Conditional

구매자 이름. Tamara 결제 수단 이용 시 필수입니다.

0email

string

🟡 Conditional

구매자 이메일 주소. Tamara 결제 수단 이용 시 필수입니다.

0phone

string

⚪ Optional

구매자 연락처

0paymentMethod

string

🔴 Required

결제 수단 코드

e.g., CARD, INSTALLMENT, DIRECT_DEBIT, BANK_TRANSFER ... etc
0purchaseChannel

string

🔴 Required

구매 채널 구분

e.g., WEB, APP
0merchantId

string

⚪ Optional

상점 ID

0successUrl

string

🔴 Required

결제 성공 후 리다이렉트될 URL

0failureUrl

string

🔴 Required

결제 실패 시 리다이렉트될 URL

0totalAmount

number

🔴 Required

실 결제 총 금액.

0subtotalAmount

number

🔴 Required

할인 전 금액.

0totalDiscountAmount

number

🔴 Required

총 할인 금액.

0discountAmount

number

🔴 Required

판매자 할인 금액.

0lgeDiscountAmount

number

🔴 Required

LG전자 할인 금액.

0nonCancelableAmount

number

🔴 Required

취소 불가 금액.

0itemName

string

🔴 Required

결제 화면에 노출될 대표 상품명

0useSavedPaymentMethod

boolean

⚪ Optional

저장된 결제 수단 사용 여부. true 설정 시 이전에 저장된 정보를 사용해 결제를 진행합니다.

e.g., true/false

default: false

0savePaymentMethod

boolean

⚪ Optional

결제 수단 저장 여부. true 설정 시 결제 성공 후 해당 결제 수단을 안전하게 저장하며, 저장된 정보는 추후 '결제 생성' 시 사용됩니다.

e.g., true/false

default: false

0autoCapture

boolean

⚪ Optional

자동 매입(Capture) 여부. true 설정 시 결제 승인(Authorized) 후 즉시 매입 처리를 진행합니다. false일 경우 추후 별도의 매입 API 호출이 필요합니다.

e.g., true/false

default: false

0nonTaxableAmount

number

⚪ Optional

비과세 대상 금액

0taxAmount

number

⚪ Optional

스토어에서 계산한 부가세 금액

0shippingAddress

object

🟡 Conditional

배송지 주소 정보입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.

1addressLine1

string

🟡 Conditional

배송지 기본 주소입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.

1addressLine2

string

⚪ Optional

배송지 상세 주소입니다.

1city

string

🟡 Conditional

배송지 도시 정보입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.

1stateOrProvince

string

⚪ Optional

배송지 주/도/지역 정보입니다.

1postalCode

string

🟡 Conditional

배송지 우편번호입니다. Tabby 결제 수단 이용 시 필수입니다.

1countryCode

string

🟡 Conditional

배송지 국가 코드(ISO 3166-1 alpha-2)입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.

0billingAddress

object

🟡 Conditional

청구지(빌링) 주소 정보입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단(paymentMethod)이 CARD이고 PG사(PgProvider)가 WorldpayAWP인 경우에도 필수입니다.

1firstName

string

🟡 Conditional

청구지 수령인 이름입니다. Tamara 결제 수단 이용 시 필수입니다.

1lastName

string

🟡 Conditional

청구지 수령인 성입니다. Tamara 결제 수단 이용 시 필수입니다.

1phoneNumber

string

🟡 Conditional

청구지 연락처 번호입니다. Tamara 결제 수단 이용 시 필수입니다.

1addressLine1

string

🟡 Conditional

청구지 기본 주소입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단이 CARD이고 PG사가 WorldpayAWP인 경우에도 필수입니다.

1addressLine2

string

⚪ Optional

청구지 상세 주소입니다.

1city

string

🟡 Conditional

청구지 도시 정보입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단이 CARD이고 PG사가 WorldpayAWP인 경우에도 필수입니다.

1stateOrProvince

string

⚪ Optional

청구지 주/도/지역 정보입니다.

1postalCode

string

⚪ Optional

청구지 우편번호입니다. 결제 수단이 CARD이고 PG사가 WorldpayAWP인 경우에 필수입니다.

1countryCode

string

🟡 Conditional

청구지 국가 코드(ISO 3166-1 alpha-2)입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단이 CARD이고 PG사가 WorldpayAWP인 경우에도 필수입니다.

0attributes

object

⚪ Optional

결제 수단별 특화 속성 정보. 아래 상세 표를 참조하십시오.

0items

array

🔴 Required

거래에 포함된 상품 리스트

1seq

number

🔴 Required

주문 내 상품의 유니크한 일련번호. 결제 취소 및 구매 확정 시 상품 식별을 위한 기준값으로 사용됩니다.

1sellerNo

string

🔴 Required

판매자를 식별하는 고유 번호

1itemType

string

⚪ Optional

상품의 유형. 정산 및 통계 관리를 위해 세분화된 유형을 입력합니다.

e.g., PHYSICAL: 실물 본품, DIGITAL: 디지털 상품, SUBSCRIPTION: 구독비, DELIVERY: 배송비, SERVICE: 서비스비
1itemId

string

🔴 Required

상품을 식별하는 고유 식별자

1itemName

string

🔴 Required

상품의 이름

1feeRate

number0 .. 100

🔴 Required

해당 상품에 적용되는 판매 수수료율

e.g., 10% -> 10, 0% -> 0
1quantity

number

🔴 Required

구매한 상품의 수량

1unitPrice

number

🔴 Required

상품의 개당 가격

1discountAmount

number

⚪ Optional

판매자가 제공하는 할인 금액

1lgeDiscountAmount

number

⚪ Optional

LG에서 제공하는 할인 금액

1paymentAmount

number

🔴 Required

상품의 실제 결제 금액 (개당 가격 - 판매자 할인 - LG 할인)

1deliveryGroupNo

string

⚪ Optional

판매자별 배송 묶음을 위한 그룹 번호

2.2.1 결제 수단별 특화 속성 (attributes) #

결제 수단 특화 속성 정보(attributes)는 연동하는 국가, PG사 및 결제 수단에 따라 전송해야 하는 필드 규격이 달라집니다. JSON 요청 시 type 필드로 해당하는 하위 속성 타입을 지정하여 전송합니다.

A. 할부 결제 (INSTALLMENT) 속성 #

depth필드상세 및 설명
1type

string

🔴 Required

특화 속성 타입 고정 값: INSTALLMENT

1installmentSource

string

🔴 Required

태국 할부 결제 기관 코드

e.g., installment_bay, installment_kbank, installment_scb, installment_ktc, installment_krungsri, installment_firstchoice
1installmentTerm

number

🔴 Required

할부 개월 수

e.g., 3, 4, 6, 10

B. 계좌 이체 (BANK_TRANSFER) 속성 #

depth필드상세 및 설명
1type

string

🔴 Required

특화 속성 타입 고정 값: BANK_TRANSFER

1bankTransferSource

string

🔴 Required

태국 계좌이체 은행 코드

e.g., mobile_banking_bay, mobile_banking_bbl, mobile_banking_kbank, mobile_banking_ktb, mobile_banking_scb
1platformType

string

🔴 Required

계좌이체 앱을 기동시킬 모바일 플랫폼 타입

e.g., IOS, ANDROID

상품 유형 가이드

  • PHYSICAL: 실물 본품 (TV, 냉장고 등)
  • DIGITAL: 디지털 상품 (소프트웨어, e-기프트카드 등)
  • SUBSCRIPTION: 구독비 (가전 렌탈, 정기 케어서비스 등)
  • DELIVERY: 배송비
  • SERVICE: 서비스비 (설치비, 철거비 등)

참고:

  • 배송그룹번호(deliveryGroupNo) 관련 예제는 여기에서 확인하세요.

2.3 요청 예시 #

신용카드
페이팔
계좌 이체 (태국)
할부 결제 (태국)
Tamara (UAE)
Tabby (UAE)
Google Pay
Apple Pay
Klarna
iDEAL
Naver Pay
Bizum
MB Way
Kredivo
Mybank
Sepa DD
Przelewy24
Bilk
PIX
SafetyPay
Transferncia Bancaria
Afterpay
BillEase
FPX
BoostPay
GrabPay
Maybank QR Pay
TnGo
Konbini
{
  "userNo": "AU1741850000100",
  "userName": "James Cook",
  "email": "james.cook@example.au",
  "phone": "+61-412-345-100",
  "shippingAddress": null,
  "billingAddress": null,
  "purchaseChannel": "WEB",
  "successUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/worldpay/success",
  "failureUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/worldpay/failure",
  "totalAmount": 1815,
  "subtotalAmount": 1815,
  "totalDiscountAmount": 0,
  "discountAmount": 0,
  "lgeDiscountAmount": 0,
  "nonCancelableAmount": 0,
  "nonTaxableAmount": 0,
  "taxAmount": 0,
  "itemName": "LG Gram 16\" Laptop",
  "savePaymentMethod": false,
  "items": [
    {
      "seq": 1,
      "sellerNo": "SELLER-001",
      "itemType": "PHYSICAL",
      "itemId": "AU_PROD_01",
      "itemName": "LG Gram 16\" Laptop",
      "quantity": 1,
      "unitPrice": 1800,
      "netAmount": 1800,
      "grossAmount": 1800,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    },
    {
      "seq": 2,
      "sellerNo": "SELLER-001",
      "itemType": "DELIVERY",
      "itemId": "AU_SHIP_01",
      "itemName": "Standard Delivery",
      "quantity": 1,
      "unitPrice": 15,
      "netAmount": 15,
      "grossAmount": 15,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    }
  ],
  "paymentMethod": "CARD",
  "useSavedPaymentMethod": false
}

{
  "userNo": "AU1741850000100",
  "userName": "James Cook",
  "email": "james.cook@example.au",
  "phone": "+61-412-345-100",
  "shippingAddress": null,
  "billingAddress": null,
  "purchaseChannel": "WEB",
  "successUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/worldpay/success",
  "failureUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/worldpay/failure",
  "totalAmount": 1800,
  "subtotalAmount": 1800,
  "totalDiscountAmount": 0,
  "discountAmount": 0,
  "lgeDiscountAmount": 0,
  "nonCancelableAmount": 0,
  "nonTaxableAmount": 0,
  "taxAmount": 0,
  "itemName": "LG Gram 16\" Laptop",
  "savePaymentMethod": false,
  "items": [
    {
      "seq": 1,
      "sellerNo": "SELLER-001",
      "itemType": "PHYSICAL",
      "itemId": "AU_PROD_01",
      "itemName": "LG Gram 16\" Laptop",
      "quantity": 1,
      "unitPrice": 1800,
      "netAmount": 1800,
      "grossAmount": 1800,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    }
  ],
  "paymentMethod": "PAYPAL",
  "useSavedPaymentMethod": false
}

{
  "userNo": "TH1741850000100",
  "userName": "Somchai Pak",
  "email": "somchai.p@example.th",
  "phone": "+66-81-234-1000",
  "shippingAddress": null,
  "billingAddress": null,
  "purchaseChannel": "WEB",
  "successUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/omise/success",
  "failureUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/omise/failure",
  "totalAmount": 26100,
  "subtotalAmount": 26100,
  "totalDiscountAmount": 0,
  "discountAmount": 0,
  "lgeDiscountAmount": 0,
  "nonCancelableAmount": 0,
  "nonTaxableAmount": 0,
  "taxAmount": 0,
  "itemName": "LG Nanocell 55\" TV",
  "savePaymentMethod": false,
  "items": [
    {
      "seq": 1,
      "sellerNo": "SELLER-001",
      "itemType": "PHYSICAL",
      "itemId": "TH_PROD_01",
      "itemName": "LG Nanocell 55\" TV",
      "quantity": 1,
      "unitPrice": 25900,
      "netAmount": 25900,
      "grossAmount": 25900,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    },
    {
      "seq": 2,
      "sellerNo": "SELLER-001",
      "itemType": "DELIVERY",
      "itemId": "TH_SHIP_01",
      "itemName": "Standard Shipping",
      "quantity": 1,
      "unitPrice": 200,
      "netAmount": 200,
      "grossAmount": 200,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    }
  ],
  "paymentMethod": "BANK_TRANSFER",
  "useSavedPaymentMethod": false,
  "attributes": {
    "type": "BANK_TRANSFER",
    "bankTransferSource": "mobile_banking_bay",
    "platformType": "IOS"
  }
}

{
  "userNo": "TH1741850000100",
  "userName": "Somchai Pak",
  "email": "somchai.p@example.th",
  "phone": "+66-81-234-1000",
  "shippingAddress": null,
  "billingAddress": null,
  "purchaseChannel": "WEB",
  "successUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/omise/success",
  "failureUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/omise/failure",
  "totalAmount": 26100,
  "subtotalAmount": 26100,
  "totalDiscountAmount": 0,
  "discountAmount": 0,
  "lgeDiscountAmount": 0,
  "nonCancelableAmount": 0,
  "nonTaxableAmount": 0,
  "taxAmount": 0,
  "itemName": "LG Nanocell 55\" TV",
  "savePaymentMethod": false,
  "items": [
    {
      "seq": 1,
      "sellerNo": "SELLER-001",
      "itemType": "PHYSICAL",
      "itemId": "TH_PROD_01",
      "itemName": "LG Nanocell 55\" TV",
      "quantity": 1,
      "unitPrice": 25900,
      "netAmount": 25900,
      "grossAmount": 25900,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    },
    {
      "seq": 2,
      "sellerNo": "SELLER-001",
      "itemType": "DELIVERY",
      "itemId": "TH_SHIP_01",
      "itemName": "Standard Shipping",
      "quantity": 1,
      "unitPrice": 200,
      "netAmount": 200,
      "grossAmount": 200,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    }
  ],
  "paymentMethod": "INSTALLMENT",
  "useSavedPaymentMethod": false,
  "attributes": {
    "type": "INSTALLMENT",
    "installmentSource": "installment_kbank",
    "installmentTerm": 3
  }
}

{
    "userNo": "AE1741850000100",
    "userName": "Zayed Ahmed",
    "email": "zayed.a@example.ae",
    "phone": "+971-50-123-4100",
    "shippingAddress": {
        "addressLine1": "Burj Khalifa, Floor 122",
        "city": "Dubai",
        "state": "Dubai",
        "postalCode": "12210",
        "countryCode": "AE"
    },
    "billingAddress": {
        "addressLine1": "Burj Khalifa, Floor 122",
        "city": "Dubai",
        "countryCode": "AE"
    },
    "purchaseChannel": "WEB",
    "successUrl": "http://localhost:8080/pgui/v2/hpp/checkoutcom/success",
    "failureUrl": "http://localhost:8080/pgui/v2/hpp/checkoutcom/failure",
    "totalAmount": 2825,
    "subtotalAmount": 2825,
    "totalDiscountAmount": 0,
    "discountAmount": 0,
    "lgeDiscountAmount": 0,
    "nonCancelableAmount": 0,
    "nonTaxableAmount": 0,
    "taxAmount": 0,
    "itemName": "LG OLED G3 65\" TV",
    "savePaymentMethod": false,
    "items": [
        {
            "seq": 1,
            "sellerNo": "SELLER-001",
            "itemType": "PRODUCT",
            "itemId": "AE_PROD_01",
            "itemName": "LG OLED G3 65\" TV",
            "quantity": 1,
            "unitPrice": 2800,
            "netAmount": 2800,
            "grossAmount": 2800,
            "discountAmount": 0,
            "lgeDiscountAmount": 0,
            "orderDiscountAllocated": 0
        },
        {
            "seq": 2,
            "sellerNo": "SELLER-001",
            "itemType": "SHIPPING",
            "itemId": "AE_SHIP_01",
            "itemName": "Premium Delivery",
            "quantity": 1,
            "unitPrice": 25,
            "netAmount": 25,
            "grossAmount": 25,
            "discountAmount": 0,
            "lgeDiscountAmount": 0,
            "orderDiscountAllocated": 0
        }
    ],
    "paymentMethod": "TAMARA",
    "useSavedPaymentMethod": false
}

{
    "userNo": "AE1741850000100",
    "userName": "Zayed Ahmed",
    "email": "zayed.a@example.ae",
    "phone": "+971-50-123-4100",
    "shippingAddress": {
        "addressLine1": "Burj Khalifa, Floor 122",
        "city": "Dubai",
        "state": "Dubai",
        "postalCode": "12210",
        "countryCode": "AE"
    },
    "purchaseChannel": "WEB",
    "successUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/checkoutcom/success",
    "failureUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/checkoutcom/failure",
    "totalAmount": 1900,
    "subtotalAmount": 1900,
    "totalDiscountAmount": 0,
    "discountAmount": 0,
    "lgeDiscountAmount": 0,
    "nonCancelableAmount": 0,
    "nonTaxableAmount": 0,
    "taxAmount": 0,
    "itemName": "LG Gram 17\" Laptop",
    "savePaymentMethod": false,
    "items": [
        {
            "seq": 1,
            "sellerNo": "SELLER-001",
            "itemType": "PHYSICAL",
            "itemId": "AE_PROD_02",
            "itemName": "LG Gram 17\" Laptop",
            "quantity": 1,
            "unitPrice": 1900,
            "netAmount": 1900,
            "grossAmount": 1900,
            "discountAmount": 0,
            "lgeDiscountAmount": 0,
            "orderDiscountAllocated": 0
        }
    ],
    "paymentMethod": "TABBY",
    "useSavedPaymentMethod": false
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "GOOGLEPAY",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 20.0,
  "subtotalAmount": 20.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "In-app Purchase",
  "phone": "+15551234567",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "In-app Purchase",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 20,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "APPLEPAY",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 25.0,
  "subtotalAmount": 25.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Subscription",
  "phone": "+15559876543",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Subscription",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 25,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "KLARNA",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 120.0,
  "subtotalAmount": 120.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Fashion Item",
  "phone": "+46701234567",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Fashion Item",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 120,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "IDEAL",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 45.5,
  "subtotalAmount": 45.5,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Home Decor",
  "phone": "+31612345678",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Home Decor",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 45.5,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "KR1741850000200",
  "userName": "이영희",
  "email": "younghee.lee@example.kr",
  "phone": "+82-10-1234-2000",
  "shippingAddress": null,
  "billingAddress": null,
  "purchaseChannel": "WEB",
  "successUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/naverpay/success",
  "failureUrl": "https://devkic-pgui.nebp.lge.com/pgui/v2/hpp/naverpay/fail",
  "totalAmount": 1800000,
  "subtotalAmount": 1800000,
  "totalDiscountAmount": 0,
  "discountAmount": 0,
  "lgeDiscountAmount": 0,
  "nonCancelableAmount": 0,
  "nonTaxableAmount": 0,
  "taxAmount": 0,
  "itemName": "LG 트롬 세탁기",
  "savePaymentMethod": false,
  "items": [
    {
      "seq": 1,
      "sellerNo": "SELLER-001",
      "itemType": "PRODUCT",
      "itemId": "KR_PROD_05",
      "itemName": "LG 트롬 세탁기",
      "quantity": 1,
      "unitPrice": 1800000,
      "netAmount": 1800000,
      "grossAmount": 1800000,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "orderDiscountAllocated": 0
    }
  ],
  "paymentMethod": "NAVER_PAY",
  "useSavedPaymentMethod": true
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "BIZUM",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 30.0,
  "subtotalAmount": 30.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Event Ticket",
  "phone": "+34600123456",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Event Ticket",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 30,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "MBWAY",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 15.0,
  "subtotalAmount": 15.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Digital Content",
  "phone": "+351912345678",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Digital Content",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 15,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "KREDIVO",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 500000.0,
  "subtotalAmount": 500000.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Electronics",
  "phone": "+628123456789",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Electronics",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 500000,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "MYBANK",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 200.0,
  "subtotalAmount": 200.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Online Course",
  "phone": "+8613800138000",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Online Course",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 200,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "SEPA_DD",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 10.0,
  "subtotalAmount": 10.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Monthly Subscription",
  "phone": "+4915123456789",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Monthly Subscription",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 10,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "PRZELEWY24",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 100.0,
  "subtotalAmount": 100.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Books",
  "phone": "+48500123456",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Books",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 100,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "BILK",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 50.0,
  "subtotalAmount": 50.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Game Credits",
  "phone": "+905321234567",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Game Credits",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 50,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "PIX",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 100.0,
  "subtotalAmount": 100.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Streaming Service",
  "phone": "+5511912345678",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Streaming Service",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 100,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "SAFETYPAY",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 75.0,
  "subtotalAmount": 75.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Travel Booking",
  "phone": "+51912345678",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Travel Booking",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 75,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "TRANS_BANC",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 200.0,
  "subtotalAmount": 200.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Furniture",
  "phone": "+5521912345678",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Furniture",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 200,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "AFTERPAY",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 150.0,
  "subtotalAmount": 150.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Clothing",
  "phone": "+61412345678",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Clothing",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 150,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "BILLEASE",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 2000.0,
  "subtotalAmount": 2000.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Smartphone",
  "phone": "+639171234567",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Smartphone",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 2000,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "FPX",
  "purchaseChannel": "WEB",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 100.0,
  "subtotalAmount": 100.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Gift Card",
  "phone": "+60123456789",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Gift Card",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 100,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "BOOSTPAY",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 50.0,
  "subtotalAmount": 50.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Mobile Top-up",
  "phone": "+60123456789",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Mobile Top-up",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 50,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "GRABPAY",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 20.0,
  "subtotalAmount": 20.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Food Delivery",
  "phone": "+6581234567",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Food Delivery",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 20,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "MAYBANK_QR",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 15.0,
  "subtotalAmount": 15.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Coffee",
  "phone": "+60123456789",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Coffee",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 15,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "TNGO",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 10.0,
  "subtotalAmount": 10.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Snacks",
  "phone": "+60123456789",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Snacks",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 10,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

{
  "userNo": "GB2501108122805",
  "paymentMethod": "CONBINI",
  "purchaseChannel": "APP",
  "successUrl": "https://example.com/success",
  "failureUrl": "https://example.com/fail",
  "totalAmount": 5000.0,
  "subtotalAmount": 5000.0,
  "totalDiscountAmount": 0.0,
  "discountAmount": 0.0,
  "lgeDiscountAmount": 0.0,
  "nonCancelableAmount": 0.0,
  "itemName": "Beverage",
  "phone": "01012345678",
  "items": [
    {
      "seq": 1,
      "sellerNo": "TEST_SELLR",
      "itemType": "PHYSICAL",
      "itemId": "Item1",
      "itemName": "Beverage",
      "feeRate": 10,
      "quantity": 1,
      "unitPrice": 5000,
      "discountAmount": 0,
      "lgeDiscountAmount": 0,
      "deliveryGroupNo": ""
    }
  ]
}

3. 응답 사양 #

3.1 응답 데이터 스키마 #

depthFieldDetails & Description
-1resultCode

string

🔴 Required

결과 코드 (성공 "0", 에러 시 "EBP-A-0001" 등)

-1message

string

🔴 Required

결과 메시지 (성공 또는 에러 상세)

-1requestId

string

🔴 Required

추적을 위한 고유 요청 ID

-1timestamp

string

🔴 Required

ISO 8601 형식의 응답 타임스탬프

e.g., 2025-12-19T14:24:00+09:00
-1data

object

🔴 Required

응답 데이터 (비즈니스 결과물)

0status

string

🔴 Required

결제 프로세스의 현재 상태. 최종 목표인 '성공'에 도달하기 위한 진행 상황을 나타냅니다.

e.g., AUTHORIZED, ACTION_REQUIRED
0paymentUrl

string

⚪ Optional

추가 인증이 필요한 경우 사용자를 이동시킬 URL입니다. EBP에서 제공하는 브릿지 페이지이거나 PG사에서 직접 제공하는 인증 페이지일 수 있습니다. requiresClientAction이 true인 경우 필수적으로 참조합니다.

0orderNo

string

🔴 Required

주문번호

0pgTransactionId

string

🔴 Required

PG 거래번호

0paymentContext

string

🔴 Required

EBP에서 발급한 암호화된 결제 컨텍스트 값입니다. '결제 생성 API' 호출 시 필수 값으로 사용됩니다.

0successUrl

string

🔴 Required

결제 성공 시 리다이렉트될 최종 URL

0failureUrl

string

🔴 Required

결제 실패 시 리다이렉트될 최종 URL

0pgResponse

object

🔴 Required

PG사 응답 상세 정보

1resultCode

string

🔴 Required

PG사 응답 결과 코드

1data

object

🔴 Required

PG사 응답 상세 데이터. 상세 규격은 하단의 [PG별 상세 응답 데이터

(#32-pg별-상세-응답-데이터-pgresponsedata) 섹션을 참조하세요.]
0savedPaymentMethods

array

⚪ Optional

사용자가 이전에 저장한 결제 수단 목록입니다. 요청 시 useSavedPaymentMethod 필드값이 true인 경우에 한해 반환됩니다.

1paymentMethod

string

🔴 Required

결제 수단 코드

e.g., CARD, DIRECT_DEBIT
1paymentMethodId

string

🔴 Required

EBP 내부에서 관리하는 결제 수단 고유 식별자

1cardNumber

string

🟡 Conditional

마스킹 처리된 카드 번호 (카드 결제 수단인 경우)

1cardIssuer

string

🟡 Conditional

카드 발급사 또는 브랜드 명 (카드 결제 수단인 경우)

1isBlocked

boolean

🔴 Required

해당 결제 수단의 사용 차단 여부 (true 시 사용 불가)

1pinErrorCount

number

🔴 Required

결제 비밀번호(PIN) 입력 오류 횟수

1isPinRegistered

boolean

🔴 Required

결제 비밀번호 등록 여부

1createdAt

string

🔴 Required

결제 수단 등록 일시 (ISO 8601)

-1instructions

object

🔴 Required

후속 처리를 위한 지시 사항 (프로세스 제어)

0nextStep

string

🔴 Required

상태를 전환하기 위해 클라이언트가 즉시 수행해야 할 행동 지시입니다.

e.g., CLIENT_ACTION, CALL_API
0completionMethod

string

🔴 Required

해당 결제가 최종적으로 완료되는 주체와 방식입니다.

e.g., WEBHOOK, API
0requiresClientAction

boolean

🔴 Required

클라이언트 추가 액션이 필요한지 여부

0clientAction

object

⚪ Optional

클라이언트의 추가 액션 지시 정보 객체. requiresClientAction이 true인 경우 필수적으로 참조합니다.

1type

string

⚪ Optional

클라이언트 액션 유형

e.g., TOKENIZE_CARD, CREATE_SOURCE, REDIRECT_TO_HPP
1pgProvider

string

⚪ Optional

액션을 처리할 PG사

1method

string

⚪ Optional

리다이렉트 시 사용할 HTTP Method

e.g., GET, POST
0requiresFollowUpApi

boolean

🔴 Required

후속 API(결제 생성 API 등) 호출이 필수인지 여부

0followUpApi

object

⚪ Optional

클라이언트 액션 완료 후 호출해야 할 후속 API 정보. requiresFollowUpApi가 true인 경우 필수적으로 참조합니다.

1method

string

⚪ Optional

후속 API의 HTTP Method

e.g., POST
1url

string

⚪ Optional

후속 API의 호출 경로

1description

string

⚪ Optional

후속 API에 대한 부연 설명

⚠️ 주의 사항 및 EBP-SDK 활용 안내

  1. instructions 하위의 응답 규격은 PG사 정책 또는 EBP 시스템 개선에 따라 사전 예고 없이 변경될 수 있습니다.
  2. 가맹점은 응답 데이터를 직접 파싱하여 결제 흐름을 구현하는 대신, EBP에서 제공하는 Client SDK (ebp-sdk.js)를 사용하는 것을 강력히 권장합니다.
  3. EBP-SDK는 내부적으로 응답 구조의 변경사항을 처리하며, 복잡한 인증 절차와 화면 전환을 자동으로 수행하여 안정적인 결제 연동을 지원합니다.

SDK 연동 방법에 대한 자세한 사항은 EBP SDK 사용 가이드를 참조하시기 바랍니다.

3.2 PG별 상세 응답 데이터 (pgResult.pgResponse) #

pgResult.pgResponse 객체의 내부 필드는 연동된 PG사 규격에 따라 다르게 구성됩니다.

Worldpay #

depth필드상세 및 설명
-1type

string

🔴 Required

PG 응답 데이터 구조를 식별하기 위한 타입 값

e.g., WORLDPAY
-1pgRefId

string

🔴 Required

PG사 거래 참조 ID

-1returnUrl

string

🔴 Required

PG사 리턴 URL

-1referenceUrl

string

🔴 Required

PG사 참조 URL
응답 예시 (pgResponse) #
{
  "pgResponse": {
    "resultCode": "PASS",
    "pgProvider": "WORLDPAY",
    "data": {
      "type": "WORLDPAY",
      "pgRefId": "3592845796",
      "returnUrl": "https://payments-test.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202603277730815&Ticket=00177500323082302hx43VA8CApQK6sui8pi4vA0GOz8s8T1zqoAcWX&source=https%3A%2F%2Fsecure-test.worldpay.com",
      "referenceUrl": "https://payments-test.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202603277730815&Ticket=00177500323082302hx43VA8CApQK6sui8pi4vA0GOz8s8T1zqoAcWX&source=https%3A%2F%2Fsecure-test.worldpay.com"
    }
  }
}

Checkout.com #

depth필드상세 및 설명
0type

string

🔴 Required

PG 응답 데이터 구조를 식별하기 위한 타입 값

e.g., CHECKOUT
0publicKey

string

🔴 Required

Checkout.com Flow를 초기화하기 위한 Public Key입니다. 클라이언트 환경에서 사용되며, 결제 UI(Flow) 마운트 시 필수적으로 전달됩니다.

0paymentSession

object

🔴 Required

Checkout.com에서 생성된 결제 세션 정보로, 결제 세션의 인증 및 보안 검증에 사용됩니다. Flow 초기화 시 함께 전달되며, 해당 결제 요청을 식별하고 보호하는 역할을 합니다.
응답 예시 (pgResponse) #
{
  "pgResponse": {
    "resultCode": "OK",
    "pgProvider": "CHECKOUT_COM",
    "data": {
      "type": "CHECKOUT",
      "publicKey": "pk_sbox_2ewvjanc7xpuduraa7tqqu...",
      "paymentSession": {
        "id": "ps_3BVPH1ROFbmWLF7NwzgppkRahGy",
        "payment_session_secret": "pss_88520096-4af1-463e-a0fb-737d169e340a",
        "payment_session_token": "YmFzZTY0:eyJpZCI6InBzXzNCVlBIMVJPRmJtV0xGN053emdwcGtSYWhHeSIsImVudGl0eV9pZCI6ImVudF8za2ZoaHZ6NXVldXRmajVtNmpkYTRhYnB6YSIsImV4cGVyaW1lbnRzIjp7fSwicHJvY2Vzc2luZ19jaGFubmVsX2lkIjoicGNfa21teXVieWMyNnpldnBrcWx0eXZqdXBvbWUiLCJhbW91bnQiOjI4MjUwMCwibG9jYWxlIjoiZW4tR0IiLCJjdXJyZW5jeSI6IkFFRCIsInBheW1lbnRfbWV0aG9kcyI6W3sidHlwZSI6ImNhcmQiLCJjYXJkX3NjaGVtZXMiOlsiVmlzYSIsIk1hc3RlcmNhcmQiXSwic2NoZW1lX2Nob2ljZV9lbmFibGVkIjpmYWxzZSwic3RvcmVfcGF5bWVudF9kZXRhaWxzIjoiZGlzYWJsZWQiLCJiaWxsaW5nX2FkZHJlc3MiOnsiY291bnRyeSI6IkFFIn19LHsidHlwZSI6ImFwcGxlcGF5IiwiZGlzcGxheV9uYW1lIjoiTEcgVUFFIiwiY291bnRyeV9jb2RlIjoiQUUiLCJjdXJyZW5jeV9jb2RlIjoiQUVEIiwibWVyY2hhbnRfY2FwYWJpbGl0aWVzIjpbInN1cHBvcnRzM0RTIl0sInN1cHBvcnRlZF9uZXR3b3JrcyI6WyJ2aXNhIiwibWFzdGVyQ2FyZCJdLCJ0b3RhbCI6eyJsYWJlbCI6IkxHIFVBRSIsInR5cGUiOiJmaW5hbCIsImFtb3VudCI6IjI4MjUifX0seyJ0eXBlIjoiZ29vZ2xlcGF5IiwibWVyY2hhbnQiOnsiaWQiOiIwODExMzA4OTM4NjI2ODg0OTk4MiIsIm5hbWUiOiJMRyBVQUUiLCJvcmlnaW4iOiJodHRwOi8vbG9jYWxob3N0OjgwODAifSwidHJhbnNhY3Rpb25faW5mbyI6eyJ0b3RhbF9wcmljZV9zdGF0dXMiOiJGSU5BTCIsInRvdGFsX3ByaWNlIjoiMjgyNSIsImNvdW50cnlfY29kZSI6IkFFIiwiY3VycmVuY3lfY29kZSI6IkFFRCJ9LCJjYXJkX3BhcmFtZXRlcnMiOnsiYWxsb3dlZF9hdXRoX21ldGhvZHMiOlsiUEFOX09OTFkiLCJDUllQVE9HUkFNXzNEUyJdLCJhbGxvd2VkX2NhcmRfbmV0d29ya3MiOlsiVklTQSIsIk1BU1RFUkNBUkQiXX19LHsidHlwZSI6InRhYmJ5IiwiY291bnRyeV9jYWxsaW5nX2NvZGVzIjpbIjk3MSJdLCJlbWFpbCI6InpheWVkLmFAZXhhbXBsZS5hZSJ9XSwiZmVhdHVyZV9mbGFncyI6WyJhbmFseXRpY3Nfb2JzZXJ2YWJpbGl0eV9lbmFibGVkIiwiZ2V0X3dpdGhfcHVibGljX2tleV9lbmFibGVkIiwibG9nc19vYnNlcnZhYmlsaXR5X2VuYWJsZWQiLCJyaXNrX2pzX2VuYWJsZWQiLCJ1c2VfYmlsbGluZ19hZGRyZXNzX2Zyb21fY29uZmlnX2Zvcl90b2tlbml6YXRpb24iLCJ1c2VfZGV2aWNlX2FwaV9mb3Jfb2JzZXJ2YWJpbGl0eSIsInVzZV9yaXNranNfdjIiLCJ1c2VfdXJsX2hhc2hfZm9yX2lmcmFtZV9wcm9wcyJdLCJyaXNrIjp7ImVuYWJsZWQiOmZhbHNlfSwibWVyY2hhbnRfbmFtZSI6IkxHIFVBRSIsInBheW1lbnRfc2Vzc2lvbl9zZWNyZXQiOiJwc3NfODg1MjAwOTYtNGFmMS00NjNlLWEwZmItNzM3ZDE2OWUzNDBhIiwiaW50ZWdyYXRpb25fZG9tYWluIjoiYXBpLnNhbmRib3guY2hlY2tvdXQuY29tIn0=",
        "_links": {
          "self": {
            "href": "https://api.sandbox.checkout.com/payment-sessions/ps_3BVPH1ROFbmWLF7NwzgppkRahGy"
          }
        }
      }
    }
  }
}

Omise #

depth필드상세 및 설명
-1publicKey

string

🔴 Required

Omise에서 발급받은 공개 키

-1amount

number

🔴 Required

결제 금액

-1currencyCode

string

🔴 Required

결제 통화 코드

-1itemName

string

🔴 Required

결제 대상 상품명

-1authRequestId

string

🔴 Required

인증 요청 식별자, 결제 생성 요청에 필수적으로 사용

-1authSignature

string

🔴 Required

요청 무결성 검증을 위한 보안 서명, 결제 생성 요청에 필수적으로 사용

-1paymentContext

string

🔴 Required

결제 컨텍스트 정보. 결제 생성 요청에 필수적으로 사용되는 암호화된 데이터 세트.
응답 예시 (pgResponse) #
{
  "pgResponse": {
    "resultCode": "OK",
    "pgProvider": "CHECKOUT_COM",
    "data": {
      "type": "CHECKOUT",
      "publicKey": "pkey_test_66lmsec8z06uh3jz...",
      "amount": 2610000,
      "currency": "THB",
      "itemName": "LG Nanocell 55\" TV",
      "authRequestId": "06EJSAKC9PX1P2VZW4YGS0X518",
      "authSignature": "GpNbvxXs5QvWk3lN2PzfWgnVP7kf/HezW47gJ5nUd3I=",
      "paymentContext": "QfAy+og0Pc7OaUKV92YAcN98rAMDMKEHW6iUl/sK3ytDWhV/+sootHKD63BwkLf7nPyrkojvOWHLw7QMY1UzpKG8zKhUDgxW+Dh8UK+VDEgPXkHcF2xSraKOt4tevD48ozwawiXoKmzg9KOQehCDLK0YYhg8yiEtqXAWEcMqpPkqNlT7mnghfWOokCMFmJQGCVP2NIMHFos8AixkMgPadZUjSLdKeFpwIWGB5LnTKZm3wUXfwDzGljYiAX8ZPfo9XNmvkrFpy3RglYqy+l7JLzR84YswVMqP0hxSPC7EfeM1GrSxwcLgBd58S9qWZeYuSn2p0w7rUFgOTLNcZ7HAK9fDw27lzlPfbqPrhL8eNB+tY3Ic8YJG9H2698Jyv2AMxCpY8N+Uu5e3VWtD2Qm17Le0ARN9ntMmKQNsXqo6HU8o2erlwBX5xddWiEPk7YYr624Je34xoxoUkyIbNAu4BA7fP6+0JFUjQsTVsmZ2GdSXysQoXualLIdTtJlqgO1KenftjQx4XfPS3pl4hxP8BV0inoo4DXcgj65YFprd5QBqC0b20efGZQ3O6PykFzDFYXvnCfLmlo6lNKHg6CawAHBK+K7RqZeRuKpH4GfR5nq3A1FqfVYTVivk3ck7JwKESHFARo6O8NLvslQ3WqClXThOKIufTLNa1o9n0L9gjTC2FDRBgPwsxgaZXHtj3Wa3zWQoH46/sAA2z39szJ+I+IgEfsx++wyKigkaDoPlsb5dII/n2ywv6HAd6F6olpLcQvvllwLpXCkB4MmupokUw9TYI1U2gd2FdYGHgFaGGzXgm20FFTbJxu9idsiR7x2G56GegIjhgXgtLzEclt9x7ZRvsOMWXHXGvXrJpSw2RWwfQCGjtUM45wPvgqQp94qMXvd330C7tAmflDeS08G+AT2SI56mG1D1rZoCj3F3sTjcxjmbbYMOuKr7cWiba9F/YeL2ivETNCyVXdnxWcFGaKlEDxyvRd5aFZuYC1OeBNDysWL76ijfDcVTFJeDJLKoeMHJfOHcGP0rUTgQvXKYrUpnO6hA0IYUuajGxLCqHE9OB0re3LNEy2GBvcN5AZyJyLM6QBO8Op//V0DaDEmamO+aQzVfIveXbGpvlVlCTmaP9MYo3TvdxN1qCsGIl0QmKoGNiP/52Abey0QeOMfFq6lEDxyvRd5aFZuYC1OeBNDr93mSDShWnbfrf0iJVfLF20PpLGJtq1A59zxD3B7GeR2Uqr6WreqxoMpEBAAKbLAR2yaDW7unSwYs3IbslqTvwyeIOm8U+/WA+raJB4ewh3Wbp9Mrurq7GaPpHB2RhOrj/S8ej8XD9QYAHnAKKL/PQJVrCzOlGggOqtOyH9t0Ek1QjXEIe+fNuAPbCbXAjw6w+2WOzVencM2MrK0GS8DBiIzOsWkGUVPZnHVS1GT2SU7FmPseKXUAnWQap5wVsDy5F/Xw3B0hFMAZdrSQLN+t",
      "savedPaymentMethods": null,
      "successUrl": "http://localhost:8080/pgui/v2/hpp/worldpay/success",
      "failureUrl": "http://localhost:8080/pgui/v2/hpp/worldpay/failure",
      "pgResponse": {
        "resultCode": "PASS",
        "pgProvider": "WORLDPAY",
        "data": {
          "type": "WORLDPAY",
          "pgRefId": "3592845796",
          "returnUrl": "https://payments-test.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202603277730815&Ticket=00177500323082302hx43VA8CApQK6sui8pi4vA0GOz8s8T1zqoAcWX&source=https%3A%2F%2Fsecure-test.worldpay.com",
          "referenceUrl": "https://payments-test.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202603277730815&Ticket=00177500323082302hx43VA8CApQK6sui8pi4vA0GOz8s8T1zqoAcWX&source=https%3A%2F%2Fsecure-test.worldpay.com"
        }
      }
    },
    "instructions": { ... }
  }
}

3.3 응답 예시 #

카드 (WorldPay)
카드 (Checkout.com)
카드 (Omise)
페이팔
계좌 이체 (태국)
할부 결제 (태국)
Tabby (UAE)
Tamara (UAE)
{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EN1Q1E42FZPN6YT5PF8BZT88",
  "timestamp": "2026-04-03T01:01:41.987427200Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/worldpay/paypal/wrapping?paymentContext=QfAy+og0Pc7OaUKV92YAcF6anMj8wv9uA0Srp+d+YmRDWhV/+sootHKD63BwkLf7nPyrko...",
    "orderNo": "ORD_7202604037731552",
    "pgTransactionId": "PGI_7202604037731554",
    "paymentContext": "QfAy+og0Pc7OaUKV92YAcF6anMj8wv9uA0Srp+d+YmRDWhV/+sootHKD63BwkLf7nPyrko...",
    "savedPaymentMethods": null,
    "successUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/worldpay/success",
    "failureUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/worldpay/failure",
    "pgResponse": {
      "resultCode": "PASS",
      "pgProvider": "WORLDPAY",
      "data": {
        "type": "WORLDPAY",
        "pgRefId": "3594289311",
        "returnUrl": "https://payments-test.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202604037731554&Ticket=00177561010184602AR5AUHvlnns9OqZOj-c3bAP0hRdc2IKQRPpfRC&source=https%3A%2F%2Fsecure-test.worldpay.com",
        "referenceUrl": "https://payments-test.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202604037731554&Ticket=00177561010184602AR5AUHvlnns9OqZOj-c3bAP0hRdc2IKQRPpfRC&source=https%3A%2F%2Fsecure-test.worldpay.com"
      }
    }
  },
  "instructions": { ... }
}

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EN4BVGAT0TJTK2EJ8RM21ZE0",
  "timestamp": "2026-04-03T07:12:16.131035200Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/checkoutcom/card/wrapping?paymentContext=QfAy+og0Pc7OaUKV92YAcJpgE/5feUx7nKM7nsA2oMRDWhV/+sootHKD63BwkLf7nPyrkojvOWHLw7QMY1UzpDeVUelxvMp...",
    "orderNo": "ORD_7202604037731761",
    "pgTransactionId": "PGI_7202604037731763",
    "paymentContext": "QfAy+og0Pc7OaUKV92YAcJpgE/5feUx7nKM7nsA2oMRDWhV/+sootHKD63BwkLf7nPyrkojvOWHLw7QMY1UzpDeVUelxvMp...",
    "savedPaymentMethods": null,
    "successUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/checkoutcom/success",
    "failureUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/checkoutcom/failure",
    "pgResponse": {
      "resultCode": "OK",
      "pgProvider": "CHECKOUT_COM",
      "data": {
        "type": "CHECKOUT",
        "publicKey": "pk_sbox_2ewvjanc7xpuduraa7tqquf5mmi",
        "paymentSession": {
          "id": "ps_3BpyWEErpjTiHWFQO6F5vYynqC5",
          "payment_session_secret": "pss_06980ec7-3169-42ac-bd97-85f1b7cc14dd",
          "payment_session_token": "YmFzZTY0:eyJpZCI6InBzXzNCcHlXRUVycGpUaUhXRlFPNkY1dll5bnFDNSIsImVudGl0eV9pZCI6ImVudF8za2ZoaHZ6NXVld...",
          "_links": {
            "self": {
              "href": "https://api.sandbox.checkout.com/payment-sessions/ps_3BpyWEErpjTiHWFQO6F5vYynqC5"
            }
          }
        }
      }
    }
  },
  "instructions": { ... }
}

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EN41W5RTTKKDX4HRE5JV7NX4",
  "timestamp": "2026-04-03T06:28:38.259142300Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/omise/card/wrapping?paymentContext=QfAy%2Bog0Pc7OaUKV92YAcOD%2FaZ2IDdOD9sJI9kzUoGtDWhV%2F%2B...",
    "orderNo": "ORD_7202604037731725",
    "pgTransactionId": "PGI_7202604037731727",
    "paymentContext": "QfAy+og0Pc7OaUKV92YAcOD/aZ2IDdOD9sJI9kzUoGtDWhV/...",
    "savedPaymentMethods": null,
    "successUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/omise/success",
    "failureUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/omise/failure",
    "pgResponse": {
      "resultCode": "OK",
      "pgProvider": "OMISE",
      "data": {
        "type": "OMISE_CARD",
        "publicKey": "pkey_test_66lmsec8z06uh3jzilx",
        "amount": 2500,
        "amountInMinorUnits": 250000,
        "currency": "THB",
        "itemName": "Wireless Charger",
        "orderNo": "ORD_7202604037731725",
        "authRequestId": "06EN41W5RTTKKDX4HRE5JV7NX4",
        "authSignature": "Ddr53aFJ/WBOkdFWcjVE6GqmHy4dciOpUbApXBUa+VU="
      }
    }
  },
  "instructions": { ... }
}

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EJSXACF3167DYF17DCKPV398",
  "timestamp": "2026-03-27T01:42:48.101231400Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/worldpay/card/wrapping?paymentContext=QfAy%2Bog0Pc7OaUKV92YAcF8bIPJ1MnoOmpeUOWd9eYRDWhV%2F...",
    "orderNo": "ORD_7202603277730925",
    "pgTransactionId": "PGI_7202603277730929",
    "paymentContext": "QfAy%2Bog0Pc7OaUKV92YAcF8bIPJ1MnoOmpeUOWd9eYRDWhV%2F...",
    "savedPaymentMethods": null,
    "successUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/worldpay/success",
    "failureUrl": "https://devkic-payapi.nebp.lge.com/pgui/v2/hpp/worldpay/failure",
    "pgResponse": {
      "resultCode": "PASS",
      "pgProvider": "WORLDPAY",
      "data": {
        "type": "WORLDPAY",
        "pgRefId": "3592852189",
        "returnUrl": "https://hpp-sandbox.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202603277730929&Ticket=00177500776844702U-c7q9YvTrz7RVzEY-WJvQbS7JfWDoR3BcNo-0&source=https%3A%2F%2Fsecure-test.worldpay.com",
        "referenceUrl": "https://hpp-sandbox.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey=LGETEST3%5EPGI_7202603277730929&Ticket=00177500776844702U-c7q9YvTrz7RVzEY-WJvQbS7JfWDoR3BcNo-0&source=https%3A%2F%2Fsecure-test.worldpay.com"
      }
    }
  },
  "instructions": { ... }
}

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EJSWXF1S9VSJVR3H832TWEY0",
  "timestamp": "2026-03-27T01:41:01.060997300Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/omise/bank-transfer/wrapping",
    "orderNo": "ORD_7202603277730917",
    "pgTransactionId": "PGI_7202603277730920",
    "paymentContext": "QfAy+og0Pc7OaUKV92YAcJpgE/5feUx7nKM7nsA2oMRDWhV/+sootHKD63BwkLf7nPyrkojvOWHLw7QMY1UzpDeVUelxvMp...",
    "savedPaymentMethods": null,
    "successUrl": "https://devkic-pgui.nebp.lge.com//pgui/v2/hpp/omise/success",
    "failureUrl": "https://devkic-pgui.nebp.lge.com//pgui/v2/hpp/omise/failure",
    "pgResponse": {
      "resultCode": "OK",
      "pgName": "OMISE",
      "data": {
        "publicKey": "pkey_test_66lmsec8z06uh3jzilx",
        "amount": 26100,
        "amountInMinorUnits": 2610000,
        "currency": "THB",
        "bankTransferSource": "mobile_banking_bay",
        "platformType": "IOS",
        "authRequestId": "06EJSWXF1S9VSJVR3H832TWEY0",
        "authSignature": "552RtzZfrEkiZE/piQ9GQ62UWC8XqkckETlzzBUnxjg=",
        "paymentContext": "QfAy+og0Pc7OaUKV92YAcJpgE/5feUx7nKM7nsA2oMRDWhV/+sootHKD63BwkLf7nPyrkojvOWHLw7QMY1UzpDeVUelxvMp..."
      }
    }
  },
  "instructions": { ... }
}

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EN40N9V7N1PQXAH0GMBN91Z4",
  "timestamp": "2026-04-03T06:23:19.800137100Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/omise/installment/wrapping?paymentContext=QfAy+og0Pc7OaUKV92YAcPQqpKNrGELf9Ty8UQO/rElDWhV/+...",
    "orderNo": "ORD_7202604037731713",
    "pgTransactionId": "PGI_7202604037731715",
    "paymentContext": "QfAy+og0Pc7OaUKV92YAcPQqpKNrGELf9Ty8UQO/rElDWhV/+...",
    "savedPaymentMethods": null,
    "successUrl": "http://localhost:8080/pgui/v2/hpp/omise/success",
    "failureUrl": "http://localhost:8080/pgui/v2/hpp/omise/failure",
    "pgResponse": {
      "resultCode": "OK",
      "pgProvider": "OMISE",
      "data": {
        "type": "OMISE_INSTALLMENT",
        "publicKey": "pkey_test_66lmsec8z06uh3jzilx",
        "amount": 2500,
        "amountInMinorUnits": 250000,
        "currencyCode": "THB",
        "authRequestId": "06EN40N9V7N1PQXAH0GMBN91Z4",
        "authSignature": "CRMmdgHJpcCiACWY6ZOGiUxOSjqTcv9zQsbVFXI3zD8=",
        "installmentSource": "installment_kbank",
        "installmentTerm": 3
      }
    }
  },
  "instructions": { ... }
}

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EN4HHZ63D5QPZD5FZV9H2ZX4",
  "timestamp": "2026-04-03T07:37:09.299115500Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/checkoutcom/tabby/wrapping?paymentContext=QfAy%2Bog0Pc7OaUKV92YAcGpbC7at%2BRppP%2...",
    "orderNo": "ORD_8202604037731809",
    "pgTransactionId": "PGI_8202604037731811",
    "paymentContext": "QfAy+og0Pc7OaUKV92YAcGpbC7at+RppP/jsdoEbGb1DWhV/+...",
    "savedPaymentMethods": null,
    "successUrl": "http://localhost:8080/pgui/v2/hpp/checkoutcom/success",
    "failureUrl": "http://localhost:8080/pgui/v2/hpp/checkoutcom/failure",
    "pgResponse": {
      "resultCode": "OK",
      "pgProvider": "CHECKOUT_COM",
      "data": {
        "type": "CHECKOUT",
        "publicKey": "pk_sbox_2ewvjanc7xpuduraa7tqquf5mmi",
        "paymentSession": {
          "id": "ps_3Bq1XyvpnV2AwXjD0CepNgDfq6P",
          "payment_session_secret": "pss_6d438e14-fecd-43d2-b23f-d038ccea89e0",
          "payment_session_token": "YmFzZTY0:eyJpZCI6InBzXzNCcTFYeXZwblYyQXdYakQwQ2VwTmdEZnE2UCIsImVudGl0eV9pZCI6ImVudF8za2ZoaHZ6NXVldXRmajVtNmpkYTRhYnB6YSIsImV4cGVyaW1lbnRzIjp7fSwicHJvY2Vzc2luZ19jaGFubmVsX2lkIjoicGNfa21teXVieWMyNnpldnBrcWx0eXZqdXBvbWUiLCJhbW91bnQiOjI4MjUwMCwibG9jYWxlIjoiZW4tR0IiLCJjdXJyZW5jeSI6IkFFRCIsInBheW1lbnRfbWV0aG9kcyI6W3sidHlwZSI6ImNhcmQiLCJjYXJkX3NjaGVtZXMiOlsiVmlzYSIsIk1hc3RlcmNhcmQiXSwic2NoZW1lX2Nob2ljZV9lbmFibGVkIjpmYWxzZSwic3RvcmVfcGF5bWVudF9kZXRhaWxzIjoiZGlzYWJsZWQiLCJiaWxsaW5nX2FkZHJlc3MiOnsiY291bnRyeSI6IkFFIn19LHsidHlwZSI6ImFwcGxlcGF5IiwiZGlzcGxheV9uYW1lIjoiTEcgVUFFIiwiY291bnRyeV9jb2RlIjoiQUUiLCJjdXJyZW5jeV9jb2RlIjoiQUVEIiwibWVyY2hhbnRfY2FwYWJpbGl0aWVzIjpbInN1cHBvcnRzM0RTIl0sInN1cHBvcnRlZF9uZXR3b3JrcyI6WyJ2aXNhIiwibWFzdGVyQ2FyZCJdLCJ0b3RhbCI6eyJsYWJlbCI6IkxHIFVBRSIsInR5cGUiOiJmaW5hbCIsImFtb3VudCI6IjI4MjUifX0seyJ0eXBlIjoiZ29vZ2xlcGF5IiwibWVyY2hhbnQiOnsiaWQiOiIwODExMzA4OTM4NjI2ODg0OTk4MiIsIm5hbWUiOiJMRyBVQUUiLCJvcmlnaW4iOiJodHRwOi8vbG9jYWxob3N0OjgwODAifSwidHJhbnNhY3Rpb25faW5mbyI6eyJ0b3RhbF9wcmljZV9zdGF0dXMiOiJGSU5BTCIsInRvdGFsX3ByaWNlIjoiMjgyNSIsImNvdW50cnlfY29kZSI6IkFFIiwiY3VycmVuY3lfY29kZSI6IkFFRCJ9LCJjYXJkX3BhcmFtZXRlcnMiOnsiYWxsb3dlZF9hdXRoX21ldGhvZHMiOlsiUEFOX09OTFkiLCJDUllQVE9HUkFNXzNEUyJdLCJhbGxvd2VkX2NhcmRfbmV0d29ya3MiOlsiVklTQSIsIk1BU1RFUkNBUkQiXX19LHsidHlwZSI6InRhYmJ5IiwiY291bnRyeV9jYWxsaW5nX2NvZGVzIjpbIjk3MSJdLCJlbWFpbCI6InpheWVkLmFAZXhhbXBsZS5hZSJ9XSwiZmVhdHVyZV9mbGFncyI6WyJhbmFseXRpY3Nfb2JzZXJ2YWJpbGl0eV9lbmFibGVkIiwiZ2V0X3dpdGhfcHVibGljX2tleV9lbmFibGVkIiwibG9nc19vYnNlcnZhYmlsaXR5X2VuYWJsZWQiLCJyaXNrX2pzX2VuYWJsZWQiLCJ1c2VfYmlsbGluZ19hZGRyZXNzX2Zyb21fY29uZmlnX2Zvcl90b2tlbml6YXRpb24iLCJ1c2VfZGV2aWNlX2FwaV9mb3Jfb2JzZXJ2YWJpbGl0eSIsInVzZV9yaXNranNfdjIiLCJ1c2VfdXJsX2hhc2hfZm9yX2lmcmFtZV9wcm9wcyJdLCJyaXNrIjp7ImVuYWJsZWQiOmZhbHNlfSwibWVyY2hhbnRfbmFtZSI6IkxHIFVBRSIsInBheW1lbnRfc2Vzc2lvbl9zZWNyZXQiOiJwc3NfNmQ0MzhlMTQtZmVjZC00M2QyLWIyM2YtZDAzOGNjZWE4OWUwIiwiaW50ZWdyYXRpb25fZG9tYWluIjoiYXBpLnNhbmRib3guY2hlY2tvdXQuY29tIn0=",
          "_links": {
            "self": {
              "href": "https://api.sandbox.checkout.com/payment-sessions/ps_3Bq1XyvpnV2AwXjD0CepNgDfq6P"
            }
          }
        }
      }
    }
  },
  "instructions": { ... }
}

{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "06EN4H3C9QMHEAZYS6YQZJC7GC",
  "timestamp": "2026-04-03T07:35:09.863177500Z",
  "data": {
    "status": "ACTION_REQUIRED",
    "paymentUrl": "/pgui/v2/hpp/checkoutcom/tamara/wrapping?paymentContext=QfAy%2Bog0Pc7OaUKV92YAcF5qAbtkl%2BEuYAbqu5aS5KFDWhV%2F%2...",
    "orderNo": "ORD_8202604037731801",
    "pgTransactionId": "PGI_8202604037731803",
    "paymentContext": "QfAy+og0Pc7OaUKV92YAcF5qAbtkl+EuYAbqu5aS5KFDWhV/...",
    "savedPaymentMethods": null,
    "successUrl": "http://localhost:8080/pgui/v2/hpp/checkoutcom/success",
    "failureUrl": "http://localhost:8080/pgui/v2/hpp/checkoutcom/failure",
    "pgResponse": {
      "resultCode": "OK",
      "pgProvider": "CHECKOUT_COM",
      "data": {
        "type": "CHECKOUT",
        "publicKey": "pk_sbox_2ewvjanc7xpuduraa7tqquf5mmi",
        "paymentSession": {
          "id": "ps_3Bq1IsElSF2ZoM1aZtuTBv4Mfg6",
          "payment_session_secret": "pss_fc314af0-b0b1-49e7-b2be-469bd6c33d50",
          "payment_session_token": "YmFzZTY0:eyJpZCI6InBzXzNCcTFJc0VsU0YyWm9NMWFadHVUQnY0TWZnNiIsImVudGl0eV9pZCI6ImVudF8za2ZoaHZ6NX...",
          "_links": {
            "self": {
              "href": "https://api.sandbox.checkout.com/payment-sessions/ps_3Bq1IsElSF2ZoM1aZtuTBv4Mfg6"
            }
          }
        }
      }
    }
  },
  "instructions": { ... }
}
Last updated: 2026-06-12 01:23:04 © 2026 LG Electronics Inc. All rights reserved.