Skip to main content

Open Payment Window

This step invokes the payment window to proceed with authentication for each payment method. Upon successful authentication, the result is sent via a POST request to the returnUrl specified during transaction registration.

[Image of payment window UI]

Important Constraints
  1. No iFrames: Do not use iFrames. Some card issuers blocking iFrame requests may cause payment failures.
  2. Minimum Window Size: To prevent the screen from appearing broken, ensure the window meets the minimum size requirements (width * height) for each issuer.
  • Samsung : 410 * 450
  • Hyundai : 390 * 450
  • Lotte : 650 * 490
  • Shinhan : 400 * 440
  • Hana : 620 * 500
  • KB Kookmin : 460 * 550
  • Woori : 600 * 517
  • BC : 500 * 400
  • Citi : 640 * 480
  • Overseas : 620 * 460

Request​

Open the URL obtained from the Transaction Registration API via a browser (GET).

Request URL
GET {Payment Window URL}
Content-type: text/html

Response (Callback to returnUrl)​

The following parameters are sent to your returnUrl upon successful authentication.

Parameters​

Field NameTypeLengthRequiredDescription
resCdString4Byte✅Response Code (Success: “0000”)
resMsgString1000Byte✅Response Message
shopOrderNoString40ByteMerchant Order No. Returns the value sent during registration.
authorizationIdString60ByteAuthorization ID. Required for the Payment Approval Request.
shopValue1String64ByteField 1, Returns the value sent during registration.
shopValue2String64ByteField 2, Returns the value sent during registration.
shopValue3String32ByteField 3, Returns the value sent during registration.
shopValue4String32ByteField 4, Returns the value sent during registration.
shopValue5String64ByteField 5, Returns the value sent during registration.
shopValue6String64ByteField 6, Returns the value sent during registration.
shopValue7String64ByteField 7, Returns the value sent during registration.