Nxos API Reference

Home

Support

Refund a Transaction

The unique reference of the asset move, set by you when creating the asset move

the specific decline reason for the asset move in case the asset-move has been declined. 
This can be a system-defined reason such as INSUFFICIENT_FUNDS, or LIMIT_EXCEEDED, or it can be
a custom defined type of so set during the transaction creation

The represantation of the destination account

Represents an account reference for asset moves.
Used to specify source or destination accounts in asset movement operations.
Exactly one of 'ref' or 'id' must be provided.

The user-defined reference of the account.

Represents the current status of an asset move.
Asset moves are transfers of assets between accounts and form the basis of transactions.
Note: LOCKED and COMPLETED statuses affect account balances, while
EXPECTED, DECLINED, and REFUNDED do not impact or release cap

Refund Transaction

Introduction

The central data structure that holds all financial information in nxos

Ledger

An entity within the ledger that holds assets

Accounts

Something of value that can be moved between accounts

Assets

The transfer of assets from one account to another

Asset Move

A group of asset moves executed together as a single, atomic operation

Transaction

The amount of a specific asset held by an account at a given time

Balance

Create Expected Payment

Attempts to reconcile an expected payment with reconciliation data such as reference code, amount, and currency.

Reconcile Expected Payment

Retrieves a list of quotes based on specified criteria.

This endpoint allows querying for quotes with filters for base and counter assets,
as well as the type of quote (BUY or SELL).

List Quotes

Initiates a transfer using a specified payout method.

- Accepts either an existing beneficiary ID or ad-hoc beneficiary data.
- Some payment rails require pre-stored beneficiary data (use beneficiary ID).
- Others allow ad-hoc beneficiary information in the request.
- The choice depends on the specific payout method and regulatory requirements.

Create Transfer

Mints a new voucher with specified parameters.

This operation creates a voucher by allocating funds from a specified source account.
The voucher is assigned a unique identifier and can be redeemed before its expiration date.

Mint Voucher

Redeems a voucher, transferring all or part of its value to a specified target account.

This operation allows for full or partial redemption of a voucher. If the redeemed value
is less than the total voucher value, the voucher remains active with the remaining balance.
Once fully redeemed, a voucher cannot be used again.

Redeem Voucher

Updates an existing voucher with new parameters.

This operation allows modification of certain voucher properties.
Typically, this might include extending the expiration date or changing the status.

Update Voucher

Retrieves a list of vouchers based on specified criteria.

List Vouchers

The Create Ledger API endpoint establishes a new ledger in the system. A ledger serves as the primary container for financial data, including accounts, assets, and transactions. Each ledger can have a unique reference for easy identification. Users can create multiple ledgers to separate different business units or use cases.

Create a Ledger

Get Ledger

The Create Account API endpoint adds a new account to the specified ledger. Each account can have a unique reference, which serves as a readable ID or account address. While optional, this reference provides an easy way to identify the account in subsequent operations. Accounts can hold multiple assets and are used to track balances and participate in transactions within the ledger.

Initialize Account

Enable Asset For Account

List Accounts

Get Asset Balance for Account

Get Balance History for an Account and Asset

Update Account

The Create Asset API endpoint adds a new asset to the specified ledger. The asset code must be unique and is used in all subsequent operations involving this asset. It can be a simple currency ISO code (e.g., USD, EUR) or include subunit precision (e.g., USD/2, USD/6) for higher accuracy.

Create Asset

List Assets

The Record Transaction API endpoint is the core method for creating and executing financial transactions in the Nxos system. It allows you to create complex, multi-asset transactions consisting of one or more asset moves, all processed atomically. 
This endpoint supports various transaction types, from simple transfers to intricate multi-hop exchanges, and includes features like idempotency through transaction references and metadata support for both transactions and individual asset moves. 
Importantly, the asset moves within a transaction are executed sequentially in the order they're included, allowing for self-funding chains where later moves can depend on the balance changes from earlier moves.

Create Transaction

The List Transactions API endpoint allows you to retrieve a paginated list of transactions within a specified ledger.

List Transactions

Retrieve an Asset Move

Retrieve a Transaction

Retrieves the history of an asset move

The Update Asset Moves API endpoint allows updating multiple asset moves in a single request. Asset moves are processed sequentially from index 0 to n-1. This order is significant as each update can affect subsequent moves.

Refund a Transaction

Headers

Path Parameters

Response