LATAM — cash orders

Cash pay-in and pay-out across Latin America at supported pay-points, powered by Pago46.

LifecycleUserWalletKYCRailFundMove money

LATAM cash orders let users fund a smart wallet with physical cash, or receive cash from it, at supported pay-points across Latin America — no bank account required.

Direction	Endpoint	Meaning
Pay-in	POST /v1/users/{userId}/latam/cash/orders/fund	User deposits cash → wallet is funded
Pay-out	POST /v1/users/{userId}/latam/cash/orders/send	Wallet is debited → user collects cash

---

Create an order

Both directions take the same body:

POST /v1/users/{userId}/latam/cash/orders/fund
{
  "smartWalletId": "7f4d6b88-80a0-4d3f-9538-9a4dfabc1234",
  "country": "MX",
  "price": "1500.00",
  "priceCurrency": "MXN",
  "description": "Wallet top-up"
}

Field
smartWalletId	required — UUID of the smart wallet to fund / debit
country	required — ISO 3166-1 alpha-2 code, e.g. "MX"
price	required — decimal string in the order currency
priceCurrency	required — a fiat currency code that maps to a supported wallet stablecoin (MXN → MEXe, USD → USDB, NGN → CNGN, CAD → CADC, EUR → EURe, GBP → GBPe), and must match the smart wallet’s currency
description	required — shown on the order, e.g. "Wallet top-up"

Pay-in (fund) response

Returns the provider order including a redirect_url — send the user there to choose a pay-point and pay the cash. Once paid, the wallet is credited.

Pay-out (send) response

Returns a signatureRequest authorizing the payout from the user’s wallet. Have the user sign it on-device with bmoni_embedded_sdk and submit the signature via POST /v1/users/{userId}/wallets/submit-signature — the cash order is placed once the debit is authorized.

---

List and track orders

GET /v1/users/{userId}/latam/cash/orders?type=FUND
GET /v1/users/{userId}/latam/cash/orders/{orderId}

List returns the user’s active order records (completed, cancelled, and expired orders are excluded). The optional type filter takes FUND or SEND. Each record has id, orderId, type, an uppercase status (CREATED, READY, PAYMENT_STARTED, …), price, expiry (pay / collect before this), and timestamps.

Get by ID returns the live provider order: id, price, price_currency, description, merchant_order_id, status, redirect_url, and return_url.