Bulk shipping addresses

Use bulk shipping when multiple physical cards should go to the same receiving address in one shipment. You configure addresses on the Business API, then send the address id as bulkShippingGroupId on each physical issue call. The API does not attach a tenant default group when you issue a card. Omit bulkShippingGroupId and the card ships individually, even if a default address exists.

Configure receiving addresses

All routes require an approved KYB token.

Method	Path	Purpose
`GET`	`/cards/bulk-shipping-addresses`	List active addresses
`GET`	`/cards/bulk-shipping-addresses/default`	Current default (copy `id` onto issue as `bulkShippingGroupId`)
`POST`	`/cards/bulk-shipping-addresses`	Create a receiving address
`PATCH`	`/cards/bulk-shipping-addresses/{id}`	Update fields
`POST`	`/cards/bulk-shipping-addresses/{id}/default`	Mark as default
`DELETE`	`/cards/bulk-shipping-addresses/{id}`	Soft-delete; another address becomes default if one remains

The first address you create becomes default. You can also send isDefault: true on create.

POST /cards/bulk-shipping-addresses

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/cards/bulk-shipping-addresses" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "line1": "123 Main Street",
    "city": "Springfield",
    "region": "Arizona",
    "postalCode": "85001",
    "countryCode": "US",
    "recipientFirstName": "Jane",
    "recipientLastName": "Doe",
    "recipientPhoneCountryCode": "1",
    "recipientPhoneNumber": "5555555555",
    "isDefault": true
  }'

Response includes a local id. Use that id as bulkShippingGroupId on issue.

Create response

{
  "id": "507f1f77bcf86cd799439022",
  "line1": "123 Main Street",
  "city": "Springfield",
  "region": "Arizona",
  "postalCode": "85001",
  "countryCode": "US",
  "recipientFirstName": "Jane",
  "recipientLastName": "Doe",
  "recipientPhoneCountryCode": "1",
  "recipientPhoneNumber": "5555555555",
  "isDefault": true
}

GET /cards/bulk-shipping-addresses/default

curl -s "https://b2b-api.easyonramp.com/api/v1/cards/bulk-shipping-addresses/default" \
  -H "Authorization: Bearer YOUR_JWT"

Issue physical cards into a group

Keep per-card shippingAddress as today. Rain still needs an individual delivery address on each card inside the bulk box. Send bulkShippingGroupId set to the address id (from create, list, or GET .../default) together with shippingAddress:

Issue physical card with bulk shipping

{
  "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"
  }
}

Unknown, deleted, or another tenant’s id returns 400.
Virtual cards must not send bulkShippingGroupId.
Omitting bulkShippingGroupId ships that card individually.

The group is set at card create time and cannot be changed later.

Editing an address

PATCH updates your stored address. The local id stays the same — keep sending that same id as bulkShippingGroupId on later issue calls. Setting default (POST .../{id}/default) only flips isDefault among your addresses.

Address characters

Recipient and address text must be Latin characters that Rain accepts: a-z, A-Z, 0-9, space, and . , # ' / & ( ) ° -.

Rain grouping notes

Cards share a bulk shipment when they use the same address id (as bulkShippingGroupId) and the same productRef (product). Rain groups cards submitted before 12:00 PM EST Monday–Friday. Bulk fulfilment requires at least two cards in the group.

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

Configure receiving addresses

Issue physical cards into a group

Editing an address

Address characters

Rain grouping notes

​Configure receiving addresses

​Issue physical cards into a group

​Editing an address

​Address characters

​Rain grouping notes

​Related

Configure receiving addresses

Issue physical cards into a group

Editing an address

Address characters

Rain grouping notes

Related