API Overview
Endpoint map
Hosted checkout
Multi-method payment session for cards, wallets, bank transfer, and alternative methods.
POST /v2/checkout
Transaction query
Pull the latest transaction state and settlement details after callback or IPN.
POST /v2/checkout/query
Server-to-server card
Direct card submission from the merchant backend. 3DS can return a redirect URL.
POST /v2/card/api
Card iframe
Create a hosted card entry URL to keep card capture inside GLODIPAY.
POST /v2/card/iframe
Refund create
Start a refund for a completed transaction.
POST /v2/refund
Refund query
Check the current state of a refund after creation or IPN updates.
POST /v2/refund/query
Test cards
| Type | Card Number | Expiry | CVV | 3DS OTP |
|---|---|---|---|---|
| Non-3DS | 4111 1111 1111 1111 | 01/30 | 029 | N/A |
| Non-3DS | 5555 5555 5555 4444 | 01/30 | 029 | N/A |
| 3DS | 4012 8888 8888 1881 | 01/30 | 029 | Success 123456, Fail 111111 |
| 3DS | 5111 1111 1111 1118 | 01/30 | 029 | Success 123456, Fail 111111 |
| 3DS | 4141 4141 4141 4141 | 12/30 | 123 | Success 123456, Fail 111111 |
Operational notes
Webhook acknowledgement
Return
{"returnCode":"100","description":"Received"} as soon as your backend receives IPN.Sandbox cards
Use the sandbox environment only. No live charges are created in test mode.
Production base URL
Production hostname is assigned from the Merchant Dashboard, so keep it configurable per merchant.
Connection modes
| Mode | Behavior |
|---|---|
DIRECT_POST | Browser is redirected to the hosted checkout page immediately. |
API | The API returns paymentLink in JSON so the merchant controls the redirect. |
Recommended reading path
- Start with the Full API Specification if you need the whole platform model.
- Use the endpoint-specific specification for the flow you are integrating.
- Switch to the interactive pages to validate payload shape and code generation.
Source Specification
For the full technical details and complete platform model, refer to the GLODIPAY API Specification v2.