Quote a direct recharge product

GET/v1/wallets/{walletId}/direct-recharge-products/{productId}/quote

Check the payout and total wallet cost before buying. A quote reserves no money and can change. Billing products (billing) are not available yet.

Permissiondirect_recharges:read

AuthenticationSigned read

Anis’s answerNot signed

Staff-set limits it counts towardAll requests

.NET SDKanis.DirectRechargeProducts.QuoteAsync(walletId, productId, amount, amountIn)

Parameters

Name	In	Type	Notes
`walletId`required	`path`	UUID	A UUID, lower-case with hyphens.
`productId`required	`path`	UUID	A UUID, lower-case with hyphens.
`amount`required	`query`	string	The amount to quote as a decimal string.
`amountIn`required	`query`	string	lyd for dinar input, fx for payout-currency input.

Request

Signed with your key. No body, no nonce.

Headers: Signature-Input, Signature, X-Anis-Date, Accept-Language (optional). The SDKs set all of them for you.

Body: none.

Responses

Status	Meaning	Body
200	Success.	DirectRechargeQuote
400	Refused: the signed request is badly built.	Problem
401	Refused: not authenticated.	Problem
403	Refused: not allowed.	Problem
404	Refused: not found, or not yours.	Problem
409	Refused: conflicts with the current state.	Problem
422	Refused: the request breaks a rule.	Problem
429	Refused: a limit was reached.	Problem
503	No decision: a dependency was unavailable.	Problem

The answers of this call are not signed — no Signature or Signature-Input header, success or refusal. There is nothing to verify; TLS protects them. Content-Digest and X-Request-Id are still present.

Refusals

A refusal of this call is a problem without a signature. Branch on its code; each links to what it means and what to do.

Error	Code	Status
Invalid credentials	`invalid_credentials`	401
Malformed signed request	`malformed_signed_request`	400
Insufficient scope	`insufficient_scope`	403
Source address not allowed	`source_ip_not_allowed`	403
Rate limited	`rate_limited`	429
Validation failed	`validation_failed`	422
Service unavailable	`dependency_unavailable`	503
Request timeout	`request_timeout`	504
Internal error	`internal_error`	500
Account not authorised	`binding_not_authorized`	403
Account inactive	`account_inactive`	403
Wallet not granted	`wallet_not_granted`	404
Not found	`resource_not_found`	404
Currency not supported	`currency_not_supported`	422
Direct recharge product unavailable	`direct_recharge_product_unavailable`	409
Amount outside limits	`amount_out_of_range`	422

Types

DirectRechargeQuote

Field	Type	Notes
`productId`always present	UUID	The selected direct recharge product id.
`payout`always present	DirectRechargePayout	The payout string and named currency; not the LYD Money shape.
`exchangeRate`always present	string	The quoted exchange rate as a decimal string.
`price`always present	Money	The LYD price including applicable location and holder adjustments.
`commission`always present	Money	The LYD commission included in total.
`total`always present	Money	The total wallet cost, as LYD Money. The balance check is exact up to 999,999.999 LYD.

DirectRechargePayout

Field	Type	Notes
`amount`always present	string	The payout amount as a decimal string.
`currency`always present	DirectRechargeCurrency	The payout currency display name object.

DirectRechargeCurrency

Field	Type	Notes
`name`always present	string	The display name supplied for this item.

Money

Field	Type	Notes
`amount`always present	string	A decimal string, never a JSON number. Wallet balances may be negative while allowed debt is used. Prices and totals follow each route's amount rules.
`currency`always present	string	An uppercase three-letter currency code, such as `LYD`. Read a wallet’s currency from `balance.currency`.
`asOf`	string (date-time)	When this price or balance was read.