Skip to main content
POST
https://services-staging.bitmama.io/api
/
v1
/
partner
/
card
curl -X POST https://services-staging.bitmama.io/api/v1/partner/card \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -H "idempotency-key: 660e8400-e29b-41d4-a716-446655440001" \
  -d '{
    "serviceId": "acme-rain-user-abc123def456ghi",
    "amount": 50
  }'

{
  "status": "success",
  "message": "Card created successfully",
  "data": {
    "serviceCardId": "acme-rain-card-xyz789jkl012mno",
    "serviceTransactionId": "acme-rain-card-transactions-pqr345"
  }
}
Creates a virtual card for a KYC-approved user. The initial funding amount is deducted from your partner wallet.
​
Authorization
string
required
Bearer token. Example: Bearer sk_staging_your_api_key
​
idempotency-key
string
required
Unique key to prevent duplicate card creation. Use a UUID.
​
serviceId
string
required
The user’s service ID returned from Create User.
​
amount
number
required
Initial funding amount in USD. Must be greater than 0 and at most 10000.
curl -X POST https://services-staging.bitmama.io/api/v1/partner/card \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -H "idempotency-key: 660e8400-e29b-41d4-a716-446655440001" \
  -d '{
    "serviceId": "acme-rain-user-abc123def456ghi",
    "amount": 50
  }'

{
  "status": "success",
  "message": "Card created successfully",
  "data": {
    "serviceCardId": "acme-rain-card-xyz789jkl012mno",
    "serviceTransactionId": "acme-rain-card-transactions-pqr345"
  }
}
There is a rate limit of 1 card per user every 5 minutes. If you need to create another card for the same user, wait for the cooldown to expire.