Create Wallet

Creates a new wallet linked to a provider. This is an async operation — the wallet is provisioned in the background. Check its status with Get Wallet.

---

Endpoint

POST /api/v2/organizations/{org_id}/wallets

Path Parameters

Parameter	Type	Required	Description
org_id	string	Yes	Your organization ID

---

Request Body

{
  "id": "1f01110f-e8b1-6188-80e5-52f68afc03c5"
}

Field	Type	Required	Description
id	string (UUID)	Yes	Provider account ID — from Get Providers

---

Request

curl -X POST "https://api.4pay.cc/api/v2/organizations/{org_id}/wallets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1f01110f-e8b1-6188-80e5-52f68afc03c5"
  }'

---

Response

201 Created

{
  "data": {
    "id": "8f3d0c3d-9f3e-4ef6-8fae-c3169025dfcb"
  }
}

The response only contains the new wallet's id. Use it to poll the wallet's status:

GET /api/v2/organizations/{org_id}/wallets/8f3d0c3d-9f3e-4ef6-8fae-c3169025dfcb

Async operation

After receiving 201 Created, poll Get Wallet Details until status is active. This typically takes a few seconds.