# 구매 API - 결제 의사 생성 ## 1. API 개요 ### 용도 [context] 이 API는 결제 프로세스를 시작하기 위해 결제 의사(Payment Intent)를 초기화합니다. 카드, 계좌 이체, 할부, 전자 지갑을 포함한 다양한 결제 수단을 지원합니다. 결제 관련 UI 제공이 필요한 경우에는 EBP에서 제공하는 [ebp-sdk.js](/docs/sdk/ebp-sdk-guide)를 필수로 사용하여 연동해야 합니다. 결제 의사 생성 후 결제 처리가 진행되면, EBP는 결과를 수신하여 웹훅을 전송하거나 가맹점의 결제 생성 API 호출을 통해 거래를 최종 완료합니다. [/context] ### 상세 정보 [table:key-value] | 항목 | 값 | | :-------------- | :-------------------- | | **API 명칭** | 결제 의사 생성 | | **API 경로** | /api/v2/payment-intents | | **API ID** | EBP_API_224 | | **HTTP 메서드** | [badge:POST,blue,lg] | | **지역** | [badge:Global,green-subtle,lg] | [/table] @@include:billing-account-creation.md@@ > 결제 의사를 생성한 후, 사용자가 결제 수단을 통해 인증을 완료하면 EBP는 결과를 알리기 위해 상점으로 웹훅을 전송합니다. > 웹훅에 대한 상세 문서는 아래 링크에서 확인할 수 있습니다. > [**결제 승인 완료 웹훅 바로가기**](/docs/webhooks/payment-authorized) ## 2. 요청 사양 ### 2.1 요청 헤더 @@include:common-headers-link.md@@ | depth | 필드 | 상세 및 설명 | |:------|:------------------|:-----------------------------------------------------------------------| | 0 | X-Idempotency-Key | [type:string] [req:Yes] [desc:동일한 결제 의사 생성 요청에 대한 중복 처리를 방지하기 위한 멱등성 키입니다.] | ### 2.2 요청 데이터 스키마 | depth | 필드 | 상세 및 설명 | |:------|:----------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 0 | userNo | [type:string] [req:Yes] [desc:사용자 번호] | | 0 | userName | [type:string] [req:Conditional] [desc:구매자 이름. Tamara 결제 수단 이용 시 필수입니다.] | | 0 | email | [type:string] [req:Conditional] [desc:구매자 이메일 주소. Tamara 결제 수단 이용 시 필수입니다.] | | 0 | phone | [type:string] [req:Optional] [desc:구매자 연락처] | | 0 | paymentMethod | [type:string] [req:Yes] [desc:결제 수단 코드 [modal:appendix/payment-method-codes#payment-methods]][eg:CARD, INSTALLMENT, DIRECT_DEBIT, BANK_TRANSFER ... etc] | | 0 | purchaseChannel | [type:string] [req:Yes] [desc:구매 채널 구분] [eg:WEB, APP] | | 0 | merchantId | [type:string] [req:Optional] [desc:상점 ID] | | 0 | successUrl | [type:string] [req:Yes] [desc: 결제 성공 후 리다이렉트될 URL] | | 0 | failureUrl | [type:string] [req:Yes] [desc: 결제 실패 시 리다이렉트될 URL] | | 0 | totalAmount | [type:number] [req:Yes] [desc:실 결제 총 금액.] | | 0 | subtotalAmount | [type:number] [req:Yes] [desc:할인 전 금액.] | | 0 | totalDiscountAmount | [type:number] [req:Yes] [desc:총 할인 금액.] | | 0 | discountAmount | [type:number] [req:Yes] [desc:판매자 할인 금액.] | | 0 | lgeDiscountAmount | [type:number] [req:Yes] [desc:LG전자 할인 금액.] | | 0 | nonCancelableAmount | [type:number] [req:Yes] [desc:취소 불가 금액.] | | 0 | itemName | [type:string] [req:Yes] [desc:결제 화면에 노출될 대표 상품명] | | 0 | useSavedPaymentMethod | [type:boolean] [req:Optional] [desc:저장된 결제 수단 사용 여부. true 설정 시 이전에 저장된 정보를 사용해 결제를 진행합니다.] [eg:true/false] [def: false] | | 0 | savePaymentMethod | [type:boolean] [req:Optional] [desc:결제 수단 저장 여부. true 설정 시 결제 성공 후 해당 결제 수단을 안전하게 저장하며, 저장된 정보는 추후 '결제 생성' 시 사용됩니다.] [eg:true/false] [def: false] | | 0 | autoCapture | [type:boolean] [req:Optional] [desc:자동 매입(Capture) 여부. true 설정 시 결제 승인(Authorized) 후 즉시 매입 처리를 진행합니다. false일 경우 추후 별도의 매입 API 호출이 필요합니다.] [eg:true/false] [def: false] | | 0 | nonTaxableAmount | [type:number] [req:Optional] [desc:비과세 대상 금액] | | 0 | taxAmount | [type:number] [req:Optional] [desc:스토어에서 계산한 부가세 금액] | | 0 | shippingAddress | [type:object] [req:Conditional] [desc:배송지 주소 정보입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.] | | 1 | addressLine1 | [type:string] [req:Conditional] [desc:배송지 기본 주소입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.] | | 1 | addressLine2 | [type:string] [req:Optional] [desc:배송지 상세 주소입니다.] | | 1 | city | [type:string] [req:Conditional] [desc:배송지 도시 정보입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.] | | 1 | stateOrProvince | [type:string] [req:Optional] [desc:배송지 주/도/지역 정보입니다.] | | 1 | postalCode | [type:string] [req:Conditional] [desc:배송지 우편번호입니다. Tabby 결제 수단 이용 시 필수입니다.] | | 1 | countryCode | [type:string] [req:Conditional] [desc:배송지 국가 코드(ISO 3166-1 alpha-2)입니다. Tabby, Tamara 결제 수단 이용 시 필수입니다.] | | 0 | billingAddress | [type:object] [req:Conditional] [desc:청구지(빌링) 주소 정보입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단(`paymentMethod`)이 `CARD`이고 PG사(`PgProvider`)가 `WorldpayAWP`인 경우에도 필수입니다.] | | 1 | firstName | [type:string] [req:Conditional] [desc:청구지 수령인 이름입니다. Tamara 결제 수단 이용 시 필수입니다.] | | 1 | lastName | [type:string] [req:Conditional] [desc:청구지 수령인 성입니다. Tamara 결제 수단 이용 시 필수입니다.] | | 1 | phoneNumber | [type:string] [req:Conditional] [desc:청구지 연락처 번호입니다. Tamara 결제 수단 이용 시 필수입니다.] | | 1 | addressLine1 | [type:string] [req:Conditional] [desc:청구지 기본 주소입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단이 `CARD`이고 PG사가 `WorldpayAWP`인 경우에도 필수입니다.] | | 1 | addressLine2 | [type:string] [req:Optional] [desc:청구지 상세 주소입니다.] | | 1 | city | [type:string] [req:Conditional] [desc:청구지 도시 정보입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단이 `CARD`이고 PG사가 `WorldpayAWP`인 경우에도 필수입니다.] | | 1 | stateOrProvince | [type:string] [req:Optional] [desc:청구지 주/도/지역 정보입니다.] | | 1 | postalCode | [type:string] [req:Optional] [desc:청구지 우편번호입니다. 결제 수단이 `CARD`이고 PG사가 `WorldpayAWP`인 경우에 필수입니다.] | | 1 | countryCode | [type:string] [req:Conditional] [desc:청구지 국가 코드(ISO 3166-1 alpha-2)입니다. Tamara 결제 수단 이용 시 필수이며, 결제 수단이 `CARD`이고 PG사가 `WorldpayAWP`인 경우에도 필수입니다.] | | 0 | attributes | [type:object] [req:Optional] [desc:결제 수단별 특화 속성 정보. 아래 상세 표를 참조하십시오.] | @@include:items.md@@ ### 2.2.1 결제 수단별 특화 속성 (attributes) 결제 수단 특화 속성 정보(`attributes`)는 연동하는 **국가, PG사 및 결제 수단**에 따라 전송해야 하는 필드 규격이 달라집니다. JSON 요청 시 `type` 필드로 해당하는 하위 속성 타입을 지정하여 전송합니다. #### A. 할부 결제 (`INSTALLMENT`) 속성 | depth | 필드 | 상세 및 설명 | |:------|:-------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 | type | [type:string] [req:Yes] [desc:특화 속성 타입 고정 값: `INSTALLMENT`] | | 1 | installmentSource | [type:string] [req:Yes] [desc:태국 할부 결제 기관 코드] [eg: installment_bay, installment_kbank, installment_scb, installment_ktc, installment_krungsri, installment_firstchoice] | | 1 | installmentTerm | [type:number] [req:Yes] [desc:할부 개월 수] [eg: 3, 4, 6, 10] | #### B. 계좌 이체 (`BANK_TRANSFER`) 속성 | depth | 필드 | 상세 및 설명 | |:------|:-------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 | type | [type:string] [req:Yes] [desc:특화 속성 타입 고정 값: `BANK_TRANSFER`] | | 1 | bankTransferSource | [type:string] [req:Yes] [desc:태국 계좌이체 은행 코드] [eg: mobile_banking_bay, mobile_banking_bbl, mobile_banking_kbank, mobile_banking_ktb, mobile_banking_scb] | | 1 | platformType | [type:string] [req:Yes] [desc:계좌이체 앱을 기동시킬 모바일 플랫폼 타입] [eg: IOS, ANDROID] | @@include:item-type.md@@ > 참고: > > - 배송그룹번호(deliveryGroupNo) 관련 예제는 여기[modal:modals/payment/delivery-group#delivery-group]에서 확인하세요. ### 2.3 요청 예시 [tabs] [tab:신용카드] ```json : scrollable { "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 } ``` [tab:페이팔] ```json : scrollable { "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 } ``` [tab:계좌 이체 (태국)] ```json : scrollable { "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" } } ``` [tab:할부 결제 (태국)] ```json : scrollable { "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 } } ``` [tab:Tamara (UAE)] ```json : scrollable { "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 } ``` [tab:Tabby (UAE)] ```json : scrollable { "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 } ``` [tab:Google Pay] ```json : scrollable { "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": "" } ] } ``` [tab:Apple Pay] ```json : scrollable { "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": "" } ] } ``` [tab:Klarna] ```json : scrollable { "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": "" } ] } ``` [tab:iDEAL] ```json : scrollable { "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": "" } ] } ``` [tab:Naver Pay] ```json : scrollable { "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 } ``` [tab:Bizum] ```json : scrollable { "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": "" } ] } ``` [tab:MB Way] ```json : scrollable { "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": "" } ] } ``` [tab:Kredivo] ```json : scrollable { "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": "" } ] } ``` [tab:Mybank] ```json : scrollable { "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": "" } ] } ``` [tab:Sepa DD] ```json : scrollable { "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": "" } ] } ``` [tab:Przelewy24] ```json : scrollable { "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": "" } ] } ``` [tab:Bilk] ```json : scrollable { "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": "" } ] } ``` [tab:PIX] ```json : scrollable { "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": "" } ] } ``` [tab:SafetyPay] ```json : scrollable { "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": "" } ] } ``` [tab:Transferncia Bancaria] ```json : scrollable { "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": "" } ] } ``` [tab:Afterpay] ```json : scrollable { "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": "" } ] } ``` [tab:BillEase] ```json : scrollable { "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": "" } ] } ``` [tab:FPX] ```json : scrollable { "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": "" } ] } ``` [tab:BoostPay] ```json : scrollable { "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": "" } ] } ``` [tab:GrabPay] ```json : scrollable { "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": "" } ] } ``` [tab:Maybank QR Pay] ```json : scrollable { "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": "" } ] } ``` [tab:TnGo] ```json : scrollable { "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": "" } ] } ``` [tab:Konbini] ```json : scrollable { "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": "" } ] } ``` [/tabs] ## 3. 응답 사양 ### 3.1 응답 데이터 스키마 @@include:standard-response.md@@ | -1 | data | [type:object] [req:Yes] [desc:응답 데이터 (비즈니스 결과물)] | | 0 | status | [type:string] [req:Yes] [desc:결제 프로세스의 현재 상태. 최종 목표인 '성공'에 도달하기 위한 진행 상황을 나타냅니다.] [eg:AUTHORIZED, ACTION_REQUIRED] | | 0 | paymentUrl | [type:string] [req:Optional] [desc:추가 인증이 필요한 경우 사용자를 이동시킬 URL입니다. EBP에서 제공하는 브릿지 페이지이거나 PG사에서 직접 제공하는 인증 페이지일 수 있습니다. `requiresClientAction`이 `true`인 경우 필수적으로 참조합니다.] | | 0 | orderNo | [type:string] [req:Yes] [desc:주문번호] | | 0 | pgTransactionId | [type:string] [req:Yes] [desc:PG 거래번호] | | 0 | paymentContext | [type:string] [req:Yes] [desc:EBP에서 발급한 암호화된 결제 컨텍스트 값입니다. '결제 생성 API' 호출 시 필수 값으로 사용됩니다.] | | 0 | successUrl | [type:string] [req:Yes] [desc:결제 성공 시 리다이렉트될 최종 URL] | | 0 | failureUrl | [type:string] [req:Yes] [desc:결제 실패 시 리다이렉트될 최종 URL] | | 0 | pgResponse | [type:object] [req:Yes] [desc:PG사 응답 상세 정보] | | 1 | resultCode | [type:string] [req:Yes] [desc:PG사 응답 결과 코드] | | 1 | data | [type:object] [req:Yes] [desc:PG사 응답 상세 데이터. 상세 규격은 하단의 [**PG별 상세 응답 데이터**](#32-pg별-상세-응답-데이터-pgresponsedata) 섹션을 참조하세요.] | | 0 | savedPaymentMethods | [type:array] [req:Optional] [desc:사용자가 이전에 저장한 결제 수단 목록입니다. 요청 시 `useSavedPaymentMethod` 필드값이 `true`인 경우에 한해 반환됩니다.] | | 1 | paymentMethod | [type:string] [req:Yes] [desc:결제 수단 코드] [eg:CARD, DIRECT_DEBIT] | | 1 | paymentMethodId | [type:string] [req:Yes] [desc:EBP 내부에서 관리하는 결제 수단 고유 식별자] | | 1 | cardNumber | [type:string] [req:Conditional] [desc:마스킹 처리된 카드 번호 (카드 결제 수단인 경우)] | | 1 | cardIssuer | [type:string] [req:Conditional] [desc:카드 발급사 또는 브랜드 명 (카드 결제 수단인 경우)] | | 1 | isBlocked | [type:boolean] [req:Yes] [desc:해당 결제 수단의 사용 차단 여부 (true 시 사용 불가)] | | 1 | pinErrorCount | [type:number] [req:Yes] [desc:결제 비밀번호(PIN) 입력 오류 횟수] | | 1 | isPinRegistered | [type:boolean] [req:Yes] [desc:결제 비밀번호 등록 여부] | | 1 | createdAt | [type:string] [req:Yes] [desc:결제 수단 등록 일시 (ISO 8601)] | | -1 | instructions | [type:object] [req:Yes] [desc:후속 처리를 위한 지시 사항 (프로세스 제어)] | | 0 | nextStep | [type:string] [req:Yes] [desc:상태를 전환하기 위해 클라이언트가 즉시 수행해야 할 행동 지시입니다.] [eg:CLIENT_ACTION, CALL_API] | | 0 | completionMethod | [type:string] [req:Yes] [desc:해당 결제가 최종적으로 완료되는 주체와 방식입니다.] [eg:WEBHOOK, API] | | 0 | requiresClientAction | [type:boolean] [req:Yes] [desc:클라이언트 추가 액션이 필요한지 여부] | | 0 | clientAction | [type:object] [req:Optional] [desc:클라이언트의 추가 액션 지시 정보 객체. `requiresClientAction`이 `true`인 경우 필수적으로 참조합니다.] | | 1 | type | [type:string] [req:Optional] [desc:클라이언트 액션 유형] [eg:TOKENIZE_CARD, CREATE_SOURCE, REDIRECT_TO_HPP] | | 1 | pgProvider | [type:string] [req:Optional] [desc:액션을 처리할 PG사] | | 1 | method | [type:string] [req:Optional] [desc:리다이렉트 시 사용할 HTTP Method] [eg:GET, POST] | | 0 | requiresFollowUpApi | [type:boolean] [req:Yes] [desc:후속 API(결제 생성 API 등) 호출이 필수인지 여부] | | 0 | followUpApi | [type:object] [req:Optional] [desc:클라이언트 액션 완료 후 호출해야 할 후속 API 정보. `requiresFollowUpApi`가 `true`인 경우 필수적으로 참조합니다.] | | 1 | method | [type:string] [req:Optional] [desc:후속 API의 HTTP Method] [eg:POST] | | 1 | url | [type:string] [req:Optional] [desc:후속 API의 호출 경로] | | 1 | description | [type:string] [req:Optional] [desc:후속 API에 대한 부연 설명] | > **⚠️ 주의 사항 및 EBP-SDK 활용 안내** > > 1. `instructions` 하위의 응답 규격은 PG사 정책 또는 EBP 시스템 개선에 따라 사전 예고 없이 변경될 수 있습니다. > 2. 가맹점은 응답 데이터를 직접 파싱하여 결제 흐름을 구현하는 대신, EBP에서 제공하는 **Client SDK (`ebp-sdk.js`)**를 사용하는 것을 강력히 권장합니다. > 3. EBP-SDK는 내부적으로 응답 구조의 변경사항을 처리하며, 복잡한 인증 절차와 화면 전환을 자동으로 수행하여 안정적인 결제 연동을 지원합니다. > > **SDK 연동 방법에 대한 자세한 사항은 [EBP SDK 사용 가이드](/docs/sdk/ebp-sdk-guide)를 참조하시기 바랍니다.** ### 3.2 PG별 상세 응답 데이터 (pgResult.pgResponse) `pgResult.pgResponse` 객체의 내부 필드는 연동된 PG사 규격에 따라 다르게 구성됩니다. #### Worldpay | depth | 필드 | 상세 및 설명 | |:------|:-------------|:--------------------------------------------------------------------------------------| | -1 | type | [type:string] [req:Yes] [desc:PG 응답 데이터 구조를 식별하기 위한 타입 값] [eg:WORLDPAY] | | -1 | pgRefId | [type:string] [req:Yes] [desc:PG사 거래 참조 ID] | | -1 | returnUrl | [type:string] [req:Yes] [desc:PG사 리턴 URL] | | -1 | referenceUrl | [type:string] [req:Yes] [desc:PG사 참조 URL] | ##### 응답 예시 (pgResponse) ```json { "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 | 필드 | 상세 및 설명 | |:------|:---------------|:----------------------------------------------------------------------------------------------------------------------------------------| | 0 | type | [type:string] [req:Yes] [desc:PG 응답 데이터 구조를 식별하기 위한 타입 값] [eg:CHECKOUT] | | 0 | publicKey | [type:string] [req: Yes] [desc: Checkout.com Flow를 초기화하기 위한 Public Key입니다. 클라이언트 환경에서 사용되며, 결제 UI(Flow) 마운트 시 필수적으로 전달됩니다.] | | 0 | paymentSession | [type:object] [req:Yes] [desc:Checkout.com에서 생성된 결제 세션 정보로, 결제 세션의 인증 및 보안 검증에 사용됩니다. Flow 초기화 시 함께 전달되며, 해당 결제 요청을 식별하고 보호하는 역할을 합니다.] | ##### 응답 예시 (pgResponse) ```json { "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 | 필드 | 상세 및 설명 | |:------|:---------------|:-----------------------------------------------------------------------------| | -1 | publicKey | [type:string] [req:Yes] [desc:Omise에서 발급받은 공개 키] | | -1 | amount | [type:number] [req:Yes] [desc:결제 금액] | | -1 | currencyCode | [type:string] [req:Yes] [desc:결제 통화 코드] | | -1 | itemName | [type:string] [req:Yes] [desc:결제 대상 상품명] | | -1 | authRequestId | [type:string] [req:Yes] [desc:인증 요청 식별자, 결제 생성 요청에 필수적으로 사용] | | -1 | authSignature | [type:string] [req:Yes] [desc:요청 무결성 검증을 위한 보안 서명, 결제 생성 요청에 필수적으로 사용] | | -1 | paymentContext | [type:string] [req:Yes] [desc:결제 컨텍스트 정보. 결제 생성 요청에 필수적으로 사용되는 암호화된 데이터 세트.] | ##### 응답 예시 (pgResponse) ```json : scrollable { "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 응답 예시 [tabs] [tab:카드 (WorldPay)] ```json : scrollable { "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": { ... } } ``` [tab:카드 (Checkout.com)] ```json : scrollable { "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": { ... } } ``` [tab:카드 (Omise)] ```json : scrollable { "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": { ... } } ``` [tab:페이팔] ```json : scrollable { "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": { ... } } ``` [tab:계좌 이체 (태국)] ```json : scrollable { "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": { ... } } ``` [tab:할부 결제 (태국)] ```json : scrollable { "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": { ... } } ``` [tab:Tabby (UAE)] ```json : scrollable { "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": { ... } } ``` [tab:Tamara (UAE)] ```json : scrollable { "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": { ... } } ``` [/tabs]