Customers
Manage customer records and payment history
Customers represent the people who pay through your payment links. Customer records are automatically created when a wallet completes a checkout session, but you can also create and manage them manually via the API.
Customer name and email fields are encrypted at rest for privacy compliance. They are decrypted automatically when retrieved via the API.
The Customer object
Unique identifier for the customer (e.g., cust_abc123).
The customer's wallet address.
Customer name. Encrypted at rest.
Customer email. Encrypted at rest.
Arbitrary key-value pairs for your own use.
Total amount spent across all completed transactions (in USD equivalent).
Total number of completed transactions.
ISO 8601 timestamp of the customer's first transaction.
ISO 8601 timestamp of the customer's most recent transaction.
ISO 8601 creation timestamp.
ISO 8601 last update timestamp.
List customers
Retrieve a paginated list of customers with optional search.
Search customers by wallet address, name, or email.
Page number for pagination.
Number of results per page (max 100).
bashcurl -X GET "https://platform-api.anyspend.com/api/v1/customers?search=acme&page=1&limit=20" \ -H "Authorization: Bearer asp_xxx"
typescriptimport { AnySpendPlatformClient } from "@b3dotfun/sdk/anyspend/platform";const platform = new AnySpendPlatformClient(process.env.ANYSPEND_API_KEY!);const { data, pagination } = await platform.customers.list({ search: "acme", page: 1, limit: 20,});
json{ "data": [ { "id": "cust_abc123", "wallet_address": "0xaabb1234ccdd5678eeff9900aabb1234ccdd5678", "name": "Alice Johnson", "email": "alice@acme.com", "metadata": { "company": "Acme Inc.", "plan": "pro" }, "total_spent": "250.00", "transaction_count": 5, "first_seen_at": "2026-01-15T10:30:00Z", "last_seen_at": "2026-02-25T14:22:00Z", "created_at": "2026-01-15T10:30:00Z", "updated_at": "2026-02-25T14:22:00Z" } ], "pagination": { "page": 1, "limit": 20, "total": 1, "total_pages": 1, "has_more": false }}
Create a customer
Manually create a customer record. This is useful for pre-registering customers before they make a payment.
The customer's wallet address.
Customer name. Will be encrypted at rest.
Customer email. Will be encrypted at rest.
Arbitrary key-value pairs (e.g., {"plan": "pro"}). Up to 50 keys, 500 character values.
If a customer with the same wallet_address already exists, the request will return a 409 Conflict error. Use the update endpoint to modify existing customers.
bashcurl -X POST "https://platform-api.anyspend.com/api/v1/customers" \ -H "Authorization: Bearer asp_xxx" \ -H "Content-Type: application/json" \ -d '{ "wallet_address": "0xaabb1234ccdd5678eeff9900aabb1234ccdd5678", "name": "Alice Johnson", "email": "alice@acme.com", "metadata": { "company": "Acme Inc.", "plan": "pro" } }'
typescriptconst customer = await platform.customers.create({ walletAddress: "0xaabb1234ccdd5678eeff9900aabb1234ccdd5678", name: "Alice Johnson", email: "alice@acme.com", metadata: { company: "Acme Inc.", plan: "pro", },});
json{ "id": "cust_abc123", "wallet_address": "0xaabb1234ccdd5678eeff9900aabb1234ccdd5678", "name": "Alice Johnson", "email": "alice@acme.com", "metadata": { "company": "Acme Inc.", "plan": "pro" }, "total_spent": "0.00", "transaction_count": 0, "first_seen_at": null, "last_seen_at": null, "created_at": "2026-02-27T10:00:00Z", "updated_at": "2026-02-27T10:00:00Z"}
Retrieve a customer
The customer ID (e.g., cust_abc123).
bashcurl -X GET "https://platform-api.anyspend.com/api/v1/customers/cust_abc123" \ -H "Authorization: Bearer asp_xxx"
typescriptconst customer = await platform.customers.get("cust_abc123");
Returns the full Customer object.
Update a customer
Update an existing customer. Only the fields you include in the request body will be updated.
The customer ID.
Updated customer name.
Updated customer email.
Updated metadata. This replaces the entire metadata object. To add a single key, include the full existing metadata plus the new key.
The wallet_address cannot be changed after creation. To associate a customer with a different wallet, create a new customer record.
bashcurl -X PATCH "https://platform-api.anyspend.com/api/v1/customers/cust_abc123" \ -H "Authorization: Bearer asp_xxx" \ -H "Content-Type: application/json" \ -d '{ "name": "Alice Johnson-Smith", "metadata": { "company": "Acme Inc.", "plan": "enterprise", "upgraded_at": "2026-02-27" } }'
typescriptconst updated = await platform.customers.update("cust_abc123", { name: "Alice Johnson-Smith", metadata: { company: "Acme Inc.", plan: "enterprise", upgraded_at: "2026-02-27", },});
Returns the updated Customer object.
Delete a customer
Permanently delete a customer record. Transaction history associated with this customer is preserved but the customer reference will show as deleted.
The customer ID.
This action is irreversible. All personally identifiable information (name, email) will be permanently deleted.
bashcurl -X DELETE "https://platform-api.anyspend.com/api/v1/customers/cust_abc123" \ -H "Authorization: Bearer asp_xxx"
typescriptawait platform.customers.delete("cust_abc123");
json{ "id": "cust_abc123", "deleted": true}
List customer transactions
Retrieve the transaction history for a specific customer.
The customer ID.
Filter by transaction status: pending, confirming, completed, failed.
Page number.
Results per page (max 100).
bashcurl -X GET "https://platform-api.anyspend.com/api/v1/customers/cust_abc123/transactions?status=completed&page=1&limit=10" \ -H "Authorization: Bearer asp_xxx"
typescriptconst { data, pagination } = await platform.customers.transactions("cust_abc123", { status: "completed", page: 1, limit: 10,});
json{ "data": [ { "id": "tx_tx001", "customer_id": "cust_abc123", "payment_link_id": "pl_abc123", "session_id": "cs_sess001", "status": "completed", "amount": "50000000", "amount_usd": "50.00", "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chain_id": 1, "tx_hash": "0x9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e", "payer_address": "0xaabb1234ccdd5678eeff9900aabb1234ccdd5678", "recipient_address": "0x1234567890abcdef1234567890abcdef12345678", "created_at": "2026-02-25T08:15:00Z", "completed_at": "2026-02-25T08:16:30Z" } ], "pagination": { "page": 1, "limit": 10, "total": 5, "total_pages": 1, "has_more": false }}
Export customers
Export your customer data in CSV or JSON format. The response is streamed as a file download.
Export format. One of: csv, json.
Filter exported customers by search term.
Exports are limited to 10,000 records. For larger datasets, use pagination with the list endpoint.
bash# Download as CSVcurl -X GET "https://platform-api.anyspend.com/api/v1/customers/export?format=csv" \ -H "Authorization: Bearer asp_xxx" \ -o customers.csv# Download as JSONcurl -X GET "https://platform-api.anyspend.com/api/v1/customers/export?format=json" \ -H "Authorization: Bearer asp_xxx" \ -o customers.json
typescript// Get export as a ReadableStreamconst csvStream = await platform.customers.export({ format: "csv" });// Or get as JSON arrayconst customers = await platform.customers.export({ format: "json" });
csvid,wallet_address,name,email,total_spent,transaction_count,first_seen_at,last_seen_at,created_atcust_abc123,0xaabb...5678,Alice Johnson,alice@acme.com,250.00,5,2026-01-15T10:30:00Z,2026-02-25T14:22:00Z,2026-01-15T10:30:00Zcust_def456,0xccdd...9012,Bob Smith,bob@example.com,100.00,2,2026-02-01T09:00:00Z,2026-02-20T16:45:00Z,2026-02-01T09:00:00Z
json{ "data": [ { "id": "cust_abc123", "wallet_address": "0xaabb1234ccdd5678eeff9900aabb1234ccdd5678", "name": "Alice Johnson", "email": "alice@acme.com", "total_spent": "250.00", "transaction_count": 5, "first_seen_at": "2026-01-15T10:30:00Z", "last_seen_at": "2026-02-25T14:22:00Z", "created_at": "2026-01-15T10:30:00Z" } ], "total": 2}