Create a wallet
Creates an empty wallet in a currency the partner has no wallet in yet.
Creates an empty wallet in a currency the partner has no wallet in yet.
Take currencyId from GET currencies. The new wallet starts with a zero balance. Without a
label it is named after its currency, for example USD wallet. The partner's first wallet is
always selected; for a later one, isSelected: true makes it the selected wallet in place of the
current one. Returns 201 without a body; list the wallets to read it.
A second wallet in the same currency returns 400 with code 17000
(WALLET_CURRENCY_ALREADY_EXISTS); a label already used by another of the partner's wallets,
ignoring case, returns 400 with code 17001 (WALLET_LABEL_ALREADY_EXISTS).
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
The wallet to create.
- body
A new wallet in a currency the partner has no wallet in yet.
currencyId?stringRequired. The currency's id from GET currencies.
uuidisSelected?booleanWhether the new wallet becomes the selected wallet that pays for orders. The partner's first wallet is always selected.
label?|Display name, unique among the partner's wallets ignoring case. Defaults to the currency
code followed by wallet, for example USD wallet.
lowBalanceThreshold?|Optional low-balance threshold in the wallet's currency. When it is above
zero, the partner.balance.low webhook reports the balance falling toward and below it.
decimalCreated
curl -X POST 'https://api.sandbox.openroam.com/v1/wallets' \ -H 'Content-Type: application/json' \ -d '{}'Update an item POST
Updates a delivered order item, without a charge. Changes what the item's kind lets a partner change after the purchase, in one call. An update never charges or refunds anything: a change with a price, such as a hotel or flight change, is an amendment (`POST /order-items/{id}/amendments/quote`). At launch only gift cards can be updated: `inputs` takes a new `recipientEmail` and `giftMessage`, and the gift email is sent again, to the new address with the new message. A card bought without a recipient needs `recipientEmail`. Every other kind of item returns `422` with code `18004` (`UPDATE_NOT_SUPPORTED`). Available when the item's `actions.update` is `available`; otherwise the update returns `409` with code `18005` (`UPDATE_NOT_AVAILABLE`), and `details[0].reason` repeats `actions.update.availability` (`IN_PROGRESS` or `NOT_AVAILABLE`). The same `409` is returned when the item stops being available during the call, for example after a cancel. A member of `inputs` left out or sent as `null` keeps its current value, and at least one member must be present. An invalid member returns `400` with code `10001` at `inputs.<member>`, with the same reasons as the order's `inputs`, and a member the item's kind does not define returns `400` with code `10001` and reason `UNSUPPORTED_FIELD`. An item of another partner, or an unknown id, returns `404` with code `10004`. A malformed body (not valid JSON, `inputs` missing, `null` or not an object, or a top-level member other than `inputs`) returns `400` with code `10001` before the item is read. The checks on the item then run in this order: `404`, `422`, `409`, then `400` for the members of `inputs`. Returns the item exactly as `GET /order-items/{id}` returns it. No webhook is sent for an update. Requires an `Idempotency-Key` header (a UUID). Repeating a completed request with the same key and body returns `200` with the item as `GET /order-items/{id}` returns it now, and changes nothing again (no gift email is sent again). One still running returns `409` with code `12002` (`IDEMPOTENCY_KEY_IN_PROGRESS`) and a `Retry-After` header, and a different body with the same key `409` with code `12001`. A request that ended in an error can be sent again with the same key and body. Updating the same item again needs a new key.
List wallets GET
Lists all of the partner's wallets. Returns the whole list as an array, without paging. Each wallet has its `id`, `label`, `balance`, whether it `isSelected` (the wallet that pays for orders) and its `currency`.