Skip to main content
The international prepaid card is what an agent uses when the USA prepaid card will not work: a merchant headquartered outside the United States, a non-USD checkout, or a shipping address outside the U.S. It differs from the USA card in one important way. GET /order-intl-card does not issue a card on the spot. The order is queued and an admin fulfills it manually, typically within 24 hours, so your agent should expect to poll across that window rather than seconds. Amounts are $100 to $1,000 on-card in whole dollars, plus a 3.8% fee on top.

​
Tell your agent

​
Queued to fulfilled

1

Agent orders the card

Your agent calls https://laso.finance/order-intl-card?amount=X over x402, where X is the on-card amount in whole USD. The x402 price is that amount plus the 3.8% fee.
2

Order is queued

The response returns a card_id whose state and status are both queued. No card number exists yet.
3

An admin fulfills the order

Fulfillment is manual and typically completes within 24 hours. Your agent polls https://laso.finance/get-card-data?card_type=Non-Reloadable%20International with the Bearer token, or by card_id, to watch for the change.
4

Card details become available

Once status is "ready", card_details is populated with the card number, expiry, CVV, and a billing_address.
5

Agent completes the purchase

Your agent enters the card details at checkout, using the returned billing_address exactly as given.
Once the order is fulfilled the card follows the same states as the USA card, documented in the card lifecycle reference.

​
Key differences from the USA card

  • Amount: $100 minimum, $1,000 maximum on-card, in whole dollars (U.S. cards go as low as $5)
  • Fee: 3.8% on top of the on-card amount
  • Fulfillment: Queued until an admin manually orders the card (typically within 24 hours). During this window the card is in state: "queued" / status: "queued".
  • Cancellation: While queued, you can cancel via POST /cancel-intl-order with the card_id. The charged amount is credited back to the account balance. Once fulfilled (state moves out of queued), cancellation is no longer possible.
  • Balance refresh: International card balances aren’t re-scraped automatically. Call POST /refresh-card-data with card_type: "Non-Reloadable International" to request an admin balance update (returns 409 if a balance update is already pending for that card).
  • card_id after fulfillment: When an admin fulfills the order, the card is reissued and the card_id changes to the issuer’s transaction id. The original queue id is preserved on the card as queued_order_card_id, and /get-card-data?card_id=<original-queue-id> keeps resolving to the fulfilled card, so you can keep polling with the same id.
  • Status values: queued (waiting for admin fulfillment), ready (card details available), complete (card fully spent), refund-requested / refunded / archived (refund flow states).
  • Billing address: the returned billing_address has required: true and the merchant AVS check is validated against exactly that address, so enter it as-is. USA cards accept any valid U.S. address; international cards do not.
  • Expiration: Like U.S. cards, international cards expire 6 months after issuance. Any balance remaining on an expired card is forfeited to the card issuer (not Laso Finance) and cannot be recovered. Spend the full balance before the expiration date.
International card orders are queued. They take up to 24 hours for an admin to fulfill, unlike the instant USA card. Only use the international card when the USA card won’t work (non-U.S. merchant or non-USD currency). If you change your mind while queued, call POST https://laso.finance/cancel-intl-order with the card_id to cancel and refund the charge back to your account balance.

​
Example: buying from an international merchant

Your agent will:
  1. Navigate to the store and find the sneakers
  2. Add the item to cart and proceed to checkout
  3. Determine the total in JPY and convert to USD (e.g. ¥38,000 ≈ $255)
  4. Call GET https://laso.finance/order-intl-card?amount=255 via x402 (pays $255 × 1.038 ≈ $264.69 USDC from wallet). The order is queued for admin fulfillment
  5. Poll GET https://laso.finance/get-card-data?card_type=Non-Reloadable%20International with the Bearer token. Until an admin fulfills the order (typically within 24 hours), the card’s status is queued. Once fulfilled, status becomes ready and card_details is populated
  6. Enter the card number, CVV, and expiry on the checkout page
  7. Enter the shipping address and complete the order

​
Check the merchant first

The merchant database is queryable per card type. Pass card_type=Non-Reloadable International to GET /search-merchants to see whether the international card is known to work somewhere before you order:
The status values and how to read them are covered under check the merchant first on the USA card page.

​
Next

Card lifecycle

The states a card moves through and the response shape at each one.