Codego Developers · Card · EEA Prepaid · v1.0

Card EEA Prepaid API Reference

European Economic Area prepaid card issuance and management — issue virtual & physical Visa / Mastercard prepaid cards under your brand, top up from a float account, manage PINs, limits, lock/unlock and receive real-time webhooks on every event.

Base URL  https://connect1-sandbox.codegotech.com/api
Auth  HTTP Basic  ·  Body content-type application/json

Authentication

Every request is authenticated with HTTP Basic — the standard Authorization: Basic <base64(user:pass)> header. You receive a username, password, client key, secret key and whitelabel id after onboarding. To request credentials, contact [email protected].

Most JSON endpoints also need a web_token + user_id in the body, obtained from the Login endpoint. Each request must include the matching whitelabel_id.

Rate limit: 200 requests / 10s per credential. Token TTL is renewed via updateLiveuser every minute — without it the session token expires.

Errors

All responses return HTTP 200 with a JSON body. The status field is the machine-readable result (1 = success, anything else = failure) and message carries a human-readable reason.

statusMeaning
1Success
0Validation failed / generic error — see message
2OTP required — confirm via the matching confirm* endpoint
-1Auth failure (invalid Basic credentials, expired web_token, or missing whitelabel_id)