Cova by Unycode

Sandbox Financial API

One API. Your key. Your ledger.

Sign up, copy your key, and call the gateway. There is one Cova Financial API. You do not create or publish APIs.

Get an API key Open API reference

1. Sign up

Get a sandbox key from the developer portal. Store it as a server-side secret.

2. Call the gateway

Send X-Api-Key to cova-api-sandbox.unycode.net/financial.

3. Stay isolated

Each key maps to its own ledger tenant. Do not send fin_test_ keys here.

Call

curl -sS \
  -H "X-Api-Key: $COVA_API_KEY" \
  https://cova-api-sandbox.unycode.net/financial/

Create a beneficiary

curl -sS \
  -H "X-Api-Key: $COVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalReference":"ben-001","partyType":"Individual"}' \
  https://cova-api-sandbox.unycode.net/financial/v1/beneficiaries

Collect

Amount only. Add participants.beneficiaryId when you will pay out. Open checkoutUrl to pay — that page loads Paddle Checkout. Use a Paddle sandbox test card.

curl -sS \
  -H "X-Api-Key: $COVA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"externalReference":"sale-001","amount":{"amountMinor":10000,"currency":"USD"},"metadata":{}}' \
  https://cova-api-sandbox.unycode.net/financial/v1/collections

Where things live

Signuphttps://cova-developers.unycode.net/signup/
Docshttps://cova-developers.unycode.net/docs/
Gatewayhttps://cova-api-sandbox.unycode.net/financial
HeaderX-Api-Key: <your signup key>

OpenAPI paths are /v1/.... On the gateway they are /financial/v1/....