curl --request POST \
--url https://b2b-api-sandbox.easyonramp.com/api/v1/cards/users/{userId}/issue \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cardType": "virtual"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440002",
"status": "active",
"last4": "4242",
"isPinSet": false,
"displayName": "Jane Doe Card",
"cardType": "virtual",
"expirationMonth": "12",
"expirationYear": "2028",
"limit": {
"amount": 500000,
"frequency": "per24HourPeriod"
}
}Issue a card
Create a virtual or physical card for an enrolled user whose EasyCard compliance is approved. Cards are issued on your EasyCard application. Path userId must be the end-user Mongo ObjectId from POST /users. For physical cards, call GET /cards/fees first; if physicalCardFee is greater than zero, send acceptCharge: true and ensure treasury USDC covers the fee. Each end user is limited to 50 non-canceled cards; each business is limited to 50 card creations per 90 days. Optional bulkShippingGroupId (address id from POST /cards/bulk-shipping-addresses) groups physical cards into one bulk shipment.
curl --request POST \
--url https://b2b-api-sandbox.easyonramp.com/api/v1/cards/users/{userId}/issue \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cardType": "virtual"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440002",
"status": "active",
"last4": "4242",
"isPinSet": false,
"displayName": "Jane Doe Card",
"cardType": "virtual",
"expirationMonth": "12",
"expirationYear": "2028",
"limit": {
"amount": 500000,
"frequency": "per24HourPeriod"
}
}Authorizations
Bearer JWT issued to your business account during onboarding
Path Parameters
Body
Use physical when the card must be produced and shipped.
virtual, physical "physical"
"Jane Doe Card"
Residential address for virtual cards. Required only when the user does not already have a stored physicalAddress. Synced to Rain (not sent as Rain card shipping).
Show child attributes
Show child attributes
Required for physical cards. Courier delivery address sent to Rain. Also upserts users.physicalAddress (phone dropped).
Show child attributes
Show child attributes
Optional bulk shipping address id from POST /cards/bulk-shipping-addresses. When set, physical cards with this id ship together. Omitted cards ship individually. Virtual cards must not send this field.
"507f1f77bcf86cd799439022"
Required when GET /cards/fees returns a non-zero physicalCardFee. Must be true to accept the once-off USDC charge.
true
Response
"550e8400-e29b-41d4-a716-446655440002"
Cards are active after issuance. terminated is set by DELETE /cards/{cardId} and cannot be reversed.
pending, active, frozen, terminated "active"
"4242"
false
"Jane Doe Card"
virtual, physical "12"
"2028"
Card spending limit from the issuer when available (amount in cents)
{
"amount": 500000,
"frequency": "per24HourPeriod"
}