CreddotDocsCreddot Docs
API referenceTransactions

Read wallet balances

Requires wallets:read. Pending is unconfirmed collection money; reserved is money held for payouts; only available can be spent.

GET
/api/v1/wallets

Requires wallets:read. Pending is unconfirmed collection money; reserved is money held for payouts; only available can be spent.

Authorization

api-key
headerx-api-key<token>

Your API key: ck_test_... for test mode, ck_live_... for live. Send it with x-api-secret (or Authorization: Bearer ).

Header Parameters

x-api-secret?string

Recommended: API secret sent over HTTPS. You may send it as Authorization: Bearer instead. If supplied, x-timestamp and x-signature are not required.

x-timestamp?string

Legacy signed mode: Unix time in milliseconds; maximum clock skew five minutes.

x-signature?string

Legacy signed mode: HMAC-SHA256(secret, timestamp.METHOD.url.idempotencyKey.bodyHash).

Response Body

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.creddot.com/api/v1/wallets'
Example Response
[  {    "id": "string",    "currency": "NGN",    "environment": "SANDBOX",    "status": "ACTIVE",    "availableBalanceMinor": "0",    "pendingBalanceMinor": "0",    "reservedBalanceMinor": "0"  }]

Read current transaction status GET

Requires transactions:read. Creation retries replay the original response; this endpoint returns current status.

Simulate a final sandbox collection or payout outcome POST

Requires sandbox:simulate and a sandbox API key. SUCCESS posts the entry; FAILED reverses it and releases payout funds. Repeating an outcome is safe; changing a terminal outcome returns 409. No real money moves.