🚀 VaultsPay API v1 is live. See what's new →
Set UpMaking Your First API Call

Making Your First API Call

Once you have an API key, the fastest way to verify everything is wired up correctly is to hit the /ping endpoint. It echoes back your account ID, the current environment, and a server timestamp.

GET/v1/ping

Request

curl https://sandbox.api.vaultspay.ae/v1/ping \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

Response

200 OK
{
  "pong": true,
  "account_id": "acct_01HX71YM6FJ3A8W7T5K6NRB2DN",
  "environment": "sandbox",
  "server_time": "2026-04-24T14:52:03.182Z",
  "api_version": "2026-04-01"
}

What to check

  1. HTTP 200 — you’re authenticated correctly.
  2. environment matches your key prefixsk_test_ should return sandbox, sk_live_ should return production.
  3. server_time is fresh — verifies clock skew. Requests more than 5 minutes out-of-sync will be rejected.

Troubleshooting

StatusError codeWhat it means
401invalid_api_keyKey is malformed, revoked, or missing the prefix.
401unauthorized_ipRequest IP is not in your allow-list.
403account_suspendedReach out to developers@vaultspay.ae.
500server_errorTransient — retry with exponential backoff.

See the full list in Errors.