Create a card

Creating a card for an end user requires an approved EasyCard application and an enrolled user. There is no per-user personal application.

Before you start

Business KYB approved
GET /business/application status is approved
End user created (POST /users) with KYC approved when required
User enrolled and GET /cards/users/{userId}/enroll status is approved

See the full checklist: Quickstart

Step 1 - Enroll the user (if not already)

POST /cards/enroll

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/cards/enroll" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"userId":"USER_ID"}'

Wait for card.enrollment.approved (or poll enroll status).

Step 2 - Issue the card

Virtual card

Send physicalAddress unless the user already has one stored (from create/update user or a prior physical issue). See Virtual and physical cards.

POST /cards/users/USER_ID/issue

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/cards/users/USER_ID/issue" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "cardType": "virtual",
    "displayName": "Jane Doe Card",
    "physicalAddress": {
      "line1": "12 Main Road",
      "city": "Johannesburg",
      "postalCode": "2000",
      "countryCode": "ZA"
    }
  }'

Physical card

Call GET /cards/fees first. If physicalCardFee is greater than zero, include acceptCharge: true (or the issue call returns a 400 with the charge). See Virtual and physical cards. Physical cards require shippingAddress. For bulk fulfilment, add optional bulkShippingGroupId set to the address id from Bulk shipping addresses. The issue API does not inject a default; omit the field for individual shipping.

GET /cards/fees

curl -s "https://b2b-api.easyonramp.com/api/v1/cards/fees" \
  -H "Authorization: Bearer YOUR_JWT"

POST /cards/users/USER_ID/issue

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/cards/users/USER_ID/issue" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "cardType": "physical",
    "displayName": "Jane Doe Physical Card",
    "acceptCharge": true,
    "bulkShippingGroupId": "507f1f77bcf86cd799439022",
    "shippingAddress": {
      "line1": "12 Main Road",
      "line2": "Suite 4",
      "city": "Johannesburg",
      "region": "Gauteng",
      "postalCode": "2000",
      "countryCode": "ZA",
      "phoneNumber": "+27821234567"
    }
  }'

Response:

{
  "id": "card-uuid",
  "status": "active",
  "last4": "4242",
  "displayName": "Jane Doe Card",
  "cardType": "virtual",
  "expirationMonth": "09",
  "expirationYear": "2029",
  "isPinSet": false,
  "limit": {
    "amount": 250000
  }
}

Limits

50 non-canceled cards per end user
50 card creations per business account every 90 days

Use GET /cards/users/{userId} to list cards for one user.

Get started

Core concepts

Common workflows

How to manage users

How to fund your business wallet

How to use cards

How to use reports

Integration services

Before you start

Step 1 - Enroll the user (if not already)

Step 2 - Issue the card

Virtual card

Physical card

Limits

Next steps

​Before you start

​Step 1 - Enroll the user (if not already)

​Step 2 - Issue the card

​Virtual card

​Physical card

​Limits

​Next steps

Before you start

Step 1 - Enroll the user (if not already)

Step 2 - Issue the card

Virtual card

Physical card

Limits

Next steps