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
resCdString4ByteResponse Code (Success: “0000”)
resMsgString1000ByteResponse 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.