Create dedicated crypto wallet
curl --request POST \
--url https://api.oyapasteaza.com/v1/crypto/dedicated-addresses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"customerReference": "CUSTOMER-1001",
"asset": "USDC",
"network": "SOLANA"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({customerReference: 'CUSTOMER-1001', asset: 'USDC', network: 'SOLANA'})
};
fetch('https://api.oyapasteaza.com/v1/crypto/dedicated-addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/crypto/dedicated-addresses"
payload = {
"customerReference": "CUSTOMER-1001",
"asset": "USDC",
"network": "SOLANA"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"status": true,
"message": "<string>",
"data": {}
}{
"status": false,
"message": "<string>",
"code": "<string>"
}Dedicated Crypto Wallets
Create crypto dedicated wallet
Assign a crypto wallet to a customer for recurring collections.
POST
/
v1
/
crypto
/
dedicated-addresses
Create dedicated crypto wallet
curl --request POST \
--url https://api.oyapasteaza.com/v1/crypto/dedicated-addresses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"customerReference": "CUSTOMER-1001",
"asset": "USDC",
"network": "SOLANA"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({customerReference: 'CUSTOMER-1001', asset: 'USDC', network: 'SOLANA'})
};
fetch('https://api.oyapasteaza.com/v1/crypto/dedicated-addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/crypto/dedicated-addresses"
payload = {
"customerReference": "CUSTOMER-1001",
"asset": "USDC",
"network": "SOLANA"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"status": true,
"message": "<string>",
"data": {}
}{
"status": false,
"message": "<string>",
"code": "<string>"
}Create a dedicated crypto collection wallet for a customer. The customer can reuse the wallet for future payments while it remains active.
Calling this endpoint again with the same
customerReference, asset, and environment returns the existing active assignment instead of creating a duplicate.
Endpoint
POST /v1/crypto/dedicated-addresses
Headers
Authorization: Bearer sk_test_xxx
Content-Type: application/json
Request body
| Field | Type | Required | Description |
|---|---|---|---|
customerReference | string | Yes | Your unique reference for the customer. |
asset | string | Yes | The crypto asset to collect. Currently supports USDC and USDT. |
network | string | Yes | The blockchain network. Currently supports SOLANA. |
metadata | object | No | Additional merchant data stored with the assignment. |
Example request
curl https://api.oyapasteaza.com/v1/crypto/dedicated-addresses \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"customerReference": "CUS_001",
"asset": "USDC",
"network": "SOLANA",
"metadata": {
"customerId": "123"
}
}'
Successful response
{
"status": true,
"message": "Dedicated crypto address created.",
"data": {
"reference": "PZCDA_4E40E9A3D6E8495C",
"customerReference": "CUS_001",
"asset": "USDC",
"network": "SOLANA",
"address": "7M9p...xQ2a",
"status": "ACTIVE",
"createdAt": "2026-08-15T09:00:00.000Z"
}
}
Give the customer the value in
address and clearly state the required asset and network.A dedicated wallet may expire after one year without a confirmed payment. Retrieve its status before displaying a previously saved wallet to a customer.
Errors
| Code | Meaning |
|---|---|
authentication_failed | The API key is missing or invalid. |
validation_failed | A required field is invalid or metadata is not an object. |
crypto_dedicated_address_failed | Pasteaza could not allocate or activate an address. |
Next step
List crypto dedicated wallets
Retrieve your customer address assignments.
Webhooks
Receive notifications when crypto payments arrive.
Authorizations
Use an sk_test_... key in the playground. Never enter a live key in shared environments.
Body
application/json