Create a wallet
Creates a wallet owned by the authenticated actor, optionally scoped to an organization. Wallets are the ownership unit for webhook endpoints, sellers, and payment intents.
/walletsCreates a wallet owned by the authenticated actor, optionally scoped to an organization. Wallets are the ownership unit for webhook endpoints, sellers, and payment intents.
JWT issued by IdentityX, signed with Ed25519
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for wallet creation. Mirrors models.CreateWalletRequest.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/wallets" \ -H "Content-Type: application/json" \ -d '{ "name": "Main Wallet", "organization_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }'{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
"organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
"name": "string",
"sandbox": true,
"fee_bps": 0,
"collector_id": "1d71b73d-897d-4e0f-85d3-9087b548c215",
"created_at": "2019-08-24T14:15:22Z"
}{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 400,
"title": "Validation Failed"
}{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 401,
"title": "Unauthenticated"
}{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 500,
"title": "Internal Server Error"
}List your wallets GET
Lists the wallets owned by the authenticated actor. NOTE: this endpoint currently returns 201 (a known quirk of the current implementation) — documented as-is.
Get a wallet by ID GET
Fetches a single wallet. NOTE: this endpoint currently returns 201 (a known quirk of the current implementation) — documented as-is.