Transfer funds

Send from a custodial wallet on either rail: type: "public" is a standard ERC-20 stablecoin transfer; type: "private" is a cAROUSD confidentialTransfer whose amount is FHE-encrypted on-chain.

Blocks up to ~90 s for the receipt; may return PENDING.

POST /transfer

Transfer funds

cURL

curl --request POST \
  --url https://aropay.aro.media/api/v1/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletId": "ckwlt0001abcd",
  "to": "0x52aE1b7c86D2f1e9021a1B4a9c3B8d55E37F9021",
  "amount": "25",
  "type": "private"
}
'

201

{
  "ok": true,
  "data": {
    "transaction": {
      "id": "cktxn0003abcd",
      "type": "PRIVATE_TRANSFER",
      "status": "CONFIRMED",
      "chainId": 11155111,
      "amount": "25.00",
      "token": "cAROUSD",
      "txHash": "0x9ac2…",
      "settlementTxHash": null,
      "explorerUrl": "https://sepolia.etherscan.io/tx/0x9ac2…",
      "fromAddress": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
      "toAddress": "0x52aE1b7c86D2f1e9021a1B4a9c3B8d55E37F9021",
      "counterparty": null,
      "walletId": "ckwlt0001abcd",
      "error": null,
      "metadata": null,
      "createdAt": "2026-08-13T09:45:00.000Z",
      "updatedAt": "2026-08-13T09:45:38.000Z"
    }
  }
}

Authorizations

apiKeyAuthsessionCookie

Authorization · string · header · default: aro_sk_your_key_here · required

AroPay API key, sent as Authorization: Bearer aro_sk_…. Created in the dashboard under Settings → API keys. Takes precedence over a session cookie when both are present.

Body

application/json

walletId · string · required

Sending wallet; must be custodial.

to · string · required

Recipient address.

Pattern: ^0x[a-fA-F0-9]{40}$

amount · string · required

Decimal string in human units.

type · enum<string> · required

Which rail to use.

Available options: public, private

Response

201

application/json

Transfer transaction.

ok · any · required

data · object · required

Show child attributes