Server-to-Server Card API
Ask AI
Endpoint contract
Send card details directly to GLODIPAY from your own server. This flow requires PCI-compliant card collection on the merchant side.
POST /v2/card/apiapplication/jsonSignature required
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
merchantId | String(1,50) | M | Merchant ID. |
orderRef | String(1,250) | M | Unique transaction reference. |
amount | Float | M | Invoice amount. Minimum 1. |
currency | String(3) | M | ISO 4217 currency code. |
cancelUrl | String(1,300) | M | HTTPS redirect URL on cancellation. |
callbackUrl | String(1,300) | M | HTTPS redirect URL after payment success. |
notificationUrl | String(1,300) | M | HTTPS webhook endpoint. |
errorUrl | String(1,300) | M | HTTPS redirect URL on payment error. |
orderDescription | String(max:3000) | M | Short order description. |
metadata | JSON | O | Attached key-value data. |
transactionDocuments | JSON | O | Supporting documents. |
paymentMethod | String | M | Must be card. |
feeBySeller | Number(0-100) | O | Seller fee percentage. |
billingFirstName | String(max:255) | M | Billing first name. |
billingLastName | String(max:255) | M | Billing last name. |
billingStreet1 | String(max:255) | M | Billing address line 1. |
billingStreet2 | String(max:255) | O | Billing address line 2. |
billingCity | String(max:255) | M | Billing city. |
billingEmail | String(max:255) | M | Buyer email. |
billingState | String(min:2,max:255) | C | Required when billingCountry is US or CA. |
billingCountry | String | M | ISO 3166-1 alpha-2 country code. |
billingPostalCode | String(max:25) | M | Postal / ZIP code. |
billingPhoneCountryCode | String(max:10) | O | Phone country code. |
billingPhoneNumber | String(max:30) | M | Phone number. |
cardNumber | String(12,19) | M | Card number. |
cardMonth | String | M | Expiry month, for example 12. |
cardYear | String | M | 2-digit expiry year, for example 30. |
cardSecurityCode | String(3,4) | M | CVV / CVC. |
customerIp | String | M | Customer IP address. |
websiteUrl | String(max:300) | O | Merchant website URL. |
expiresAt | String | O | ISO 8601 session expiry. |
browserDetails | JSON | M | Browser fingerprint object. |
signature | String(max:750) | M | RSA-MD5 signature. |
Response cases
Response status values:
success— Payment completed immediately.data.transactionIdis returned.redirect— 3DS required. Redirect the buyer todata.url. After 3DS GLODIPAY sends the result via IPN and redirects the buyer tocallbackUrl.pending— Awaiting PSP confirmation. Final result will be sent via IPN.error— Payment failed. HTTP 422 for validation errors (witherrorsarray), HTTP 400/500 for processing errors.
Source
This page is derived from Server-to-Server Card API.