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
- No iFrames: Do not use iFrames. Some card issuers blocking iFrame requests may cause payment failures.
- 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 Name | Type | Length | Required | Description |
|---|---|---|---|---|
| resCd | String | 4Byte | ✅ | Response Code (Success: “0000”) |
| resMsg | String | 1000Byte | ✅ | Response Message |
| shopOrderNo | String | 40Byte | Merchant Order No. Returns the value sent during registration. | |
| authorizationId | String | 60Byte | Authorization ID. Required for the Payment Approval Request. | |
| shopValue1 | String | 64Byte | Field 1, Returns the value sent during registration. | |
| shopValue2 | String | 64Byte | Field 2, Returns the value sent during registration. | |
| shopValue3 | String | 32Byte | Field 3, Returns the value sent during registration. | |
| shopValue4 | String | 32Byte | Field 4, Returns the value sent during registration. | |
| shopValue5 | String | 64Byte | Field 5, Returns the value sent during registration. | |
| shopValue6 | String | 64Byte | Field 6, Returns the value sent during registration. | |
| shopValue7 | String | 64Byte | Field 7, Returns the value sent during registration. |