Products & assets
| Term | Meaning |
|---|---|
| Stablebond | A tokenized, yield-bearing sovereign bond (for example CETES). It earns the yield of the underlying government debt while you hold it on-chain. |
| Stablecoin | A token pegged to a fiat currency, such as USDC. |
Stablebonds
Stablebonds are yield-bearing: they accrue the yield of the underlying sovereign debt while you hold them.Token addresses
Each stablebond is deployed on multiple chains, each with its own mint (Solana), asset issuer (Stellar), or token contract (EVM). The addresses below are pulled live and link to each chain’s block explorer. Use them to verify a token, add a trustline, or import the asset. When you quote, always use the token’sasset from GET /supported_assets and do not hardcode addresses. Sandbox identifiers differ from these production ones.
Payment accounts
| Term | Meaning |
|---|---|
| Payment account | A bank account or a wallet that money moves from or to. You register both with POST /organization/{organizationId}/payment_account, and quotes name them by id. |
Kind (kind) | What sort of account it is: bank or wallet. The request returns 422 unsupported for debitCard and cash. |
| Rail | The network that moves the money: spei or pix for a bank account, or the chain (stellar, solana, base, polygon, monad, avalanche) for a wallet. |
| accountDetails | The identifier that names the account, tagged by its own kind: clabe (a CLABE), pixKey (a Pix key), or address (a wallet address plus its chain). We do not return it on reads. |
| registrationInfo | Account holder details a bank route needs, such as accountHolderName and taxId. We fill what we can from the verified identity of the organization in the route; a 422 registration-info-required lists what you still have to send. |
| Route readiness | The account’s status on one rail in one direction, under rails.<rail>.source (money leaving the account) and rails.<rail>.destination (money arriving). Each is pending, ready, rejected or disabled, and you can quote a direction only when it is ready. A direction is null when the rail cannot move money that way. |
Default rail (isDefault) | The rail a quote uses for a side when the quote does not name one. |
Transaction types
| Term | Meaning |
|---|---|
| Onramp | Buying tokens with fiat: the customer pays from a bank account and receives tokens in a wallet. |
| Offramp | Selling tokens for fiat: the customer sends tokens from a wallet and receives fiat in a bank account. |
| Swap | Exchanging one token for another on the same chain. |
| Cross-chain transfer | Sending a token from a wallet on one supported chain to a wallet on another. |
| Quote | Pricing for a transfer between two payment accounts, from POST /organization/{organizationId}/quote. Create the order before expiresAt, 2 minutes after the quote is created. |
| Order | A transfer created from a quote with POST /organization/{organizationId}/order. The order id equals the quoteId, and sending the same quoteId again returns the same order. |
| Order status | created, funded, claimable, completed, failed, canceled or refunded. |
| Authorization | The account holder’s approval of a transfer we built, such as an offramp from an embedded wallet. While one is pending, the order’s authorization holds the message to sign, and POST /organization/{organizationId}/order/{id}/authorization takes the signature. |
| Claimable | The order status after we deliver the funds, while the customer still has to accept them. claimInstructions holds what they need, and POST /organization/{organizationId}/order/{id}/claim prepares the claim. |
Funding instructions (fundingInstructions) | How the source funds an order: the rail, our reference, the destination to pay (a CLABE for SPEI, a BR Code for Pix, an address for a wallet), and the fundingDeadline. |
Fiat & banking (Mexico)
| Term | Meaning |
|---|---|
| MXN | Mexican peso. |
| SPEI | Mexico’s real-time interbank electronic transfer system. |
| CLABE | The 18-digit standardized Mexican bank account number used for SPEI transfers. Registered as accountDetails of kind clabe. |
| RFC | Mexican taxpayer ID (Registro Federal de Contribuyentes). Sandbox uses placeholder RFCs such as XAXX010101000. See the Test environment. |
Fiat & banking (Brazil)
| Term | Meaning |
|---|---|
| BRL | Brazilian real, the fiat currency for Brazil ramps. |
| Pix | Brazil’s instant payment system, operated by the Central Bank of Brazil. The Brazilian equivalent of SPEI. |
Pix key (pixKey) | The identifier a Pix payment is sent to: a CPF, CNPJ, email, phone number, or random key. Registered as accountDetails of kind pixKey. |
BR Code (brCode) | The Pix payment code in an order’s funding instructions when the source pays over Pix. |
| CPF | Brazilian individual taxpayer ID (Cadastro de Pessoas Físicas). The Brazilian analog of Mexico’s RFC. |
| CNPJ | Brazilian business taxpayer ID (Cadastro Nacional da Pessoa Jurídica). |
Identity & compliance
| Term | Meaning |
|---|---|
| KYC | Know Your Customer: identity verification for an individual (personal customer). |
| KYB | Know Your Business: verification of a business entity, such as your organization for production access. |
| Partner fee | An additional fee (up to 500 bps) a partner can add on top of the platform fee. It appears as a partnerFee line in a quote’s fees. See Fees. |
| bps | Basis points. 1 bps = 0.01%; 100 bps = 1%. |
On-chain
| Term | Meaning |
|---|---|
| Wallet | A blockchain address registered as a payment account of kind wallet, with accountDetails of kind address and its chain. |
| Trustline | (Stellar) Authorization a wallet must establish before it can hold a given asset. |
| XDR | (Stellar) The encoded transaction format a user signs, for example the xdr in a claim transaction. |
| Claimable balance | (Stellar) A pending balance the recipient claims. A claimable Stellar order carries one in claimInstructions with kind stellarClaimableBalance. |
Prepared transaction (preparedTransaction) | A transaction we build for the customer to sign and submit when a wallet funds an order. It sits in the funding destination. A Solana or Stellar transaction goes stale after refreshAfter; a Stellar or EVM transaction also goes stale when the wallet’s sequence number or nonce moves. Refresh the funding instructions to get a new one. |
| Stellar anchor | A bridge between the Stellar network and traditional fiat rails, defined by Stellar Ecosystem Proposals (SEPs). Etherfuse acts as an anchor for Stellar offramps. Learn more ↗ |
Verification
| Term | Meaning |
|---|---|
| KYC WebSDK | The hosted verification flow: you create the customer and launch them, and they complete every step in the widget. See KYC WebSDK. |
| KYC API | Pushing a customer’s personal data, documents and questionnaire answers over the API so they aren’t asked for them again, then launching them only for what is left. See KYC API. |
| Share token | A single-use share token created in a partner’s own Sumsub account. It hands Etherfuse a verification the customer already passed, so documents and liveness transfer. Requires a data-sharing agreement. See KYC Sumsub Shared Token. |
| Requirement | One step in a customer’s verification, named by its type, with a status and a requiresLaunch flag that is true when only the customer can satisfy it. Returned by GET /organization/{organizationId}/kyc?requirements=true. See Tracking verification status. |
Organization & events
| Term | Meaning |
|---|---|
| Child organization | A sub-organization you create (and can apply a partner fee to) on behalf of a partner or customer. |
| organizationId | The organization a payment account, quote or order call acts for, in the route /organization/{organizationId}/.... It is your own organization or one of your direct customer organizations. Any other id returns 404 not-found. See Organizations in the route. |
| Webhook | An HMAC-signed HTTP callback. Subscribe with POST /webhook_subscription to orderUpdated, paymentAccountUpdated, kycUpdated or kybUpdated. See Webhooks. |