Accept a quote | CrissCross

curl -X POST https://api.crisscross.money/v1/toc/quotes/qut_550e8400-e29b-41d4-a716-446655440000/accept \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "beneficiaryAccountId": "acc_550e8400-e29b-41d4-a716-446655440000",
  "bopCategoryId": "bop_550e8400-e29b-41d4-a716-446655440000",
  "icn": "INV123456"
}'

{
  "orderId": "ord_550e8400-e29b-41d4-a716-446655440000",
  "quoteId": "qut_550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "dealId": "NDK-2026-00123",
  "sellCurrency": "ZAR",
  "buyCurrency": "USD",
  "sellAmount": "100000.00",
  "buyAmount": "5400.00",
  "rate": "0.054",
  "fee": "850.00",
  "totalSellAmount": "100850.00",
  "beneficiaryAccountId": "acc_550e8400-e29b-41d4-a716-446655440000",
  "bopCategoryId": "bop_550e8400-e29b-41d4-a716-446655440000",
  "icn": "INV123456",
  "createdAt": "2026-05-18T14:15:55Z",
  "updatedAt": "2026-05-18T14:15:55Z",
  "tdn": null,
  "cma": null
}

Accepts a quote and locks in the exchange rate. The quote must still be active (not yet expired), and each quote can only be accepted once.

Authentication

AuthorizationBearer

Token obtained via the login flow.

Path parameters

quoteIdstringRequired

Request

This endpoint expects an object.

beneficiaryAccountIdstringRequired

Prefixed UUID of the TOC beneficiary account to credit.

bopCategoryIdstringRequired

Prefixed UUID of the BOP category for SARB reporting.

icnstringRequired

Investment Certificate Number or Mandate Reference Number.

tdnstringOptional

Tax Directive Number (optional).

Response

Order created successfully.

orderIdstring

quoteIdstring

statusenum

dealIdstring

Nedbank deal number.

sellCurrencystring

buyCurrencystring

sellAmountstring

buyAmountstring

ratestring

feestring

totalSellAmountstring

Total ZAR debit. sellAmount + fee.

beneficiaryAccountIdstring

bopCategoryIdstring

icnstring

createdAtdatetime

updatedAtdatetime

tdnstring or null

cmaboolean or null

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error