WakaPay Docs

API Reference

Fiat

← All tags

Purpose

Fiat endpoints help when you need conversions, settlement amounts, or fiat-specific integration steps around crypto payments.

When to use

  • Use these when displaying local currency totals to customers.
  • Treat rates as time-sensitive; cache conservatively if needed.
post/fiat/cash-in-deposit

In-person cash deposit

Auth

Record an in-person cash deposit (branch/cash desk). For customers, amount above 750,000 requires source of funds documentation. Does not use online payment gateways.

operationId: FiatController_cashInDeposittag: Fiatpermalink
get/fiat/customers

List my customers (merchant)

Auth

Customers who have completed at least one merchant payment to you. Use JWT (logged-in user = merchant). Paginated.

operationId: FiatController_getCustomerstag: Fiatpermalink
get/fiat/deposit-numbers

List saved deposit / top-up payer numbers

Auth

Fetch on login and persist in cache; refetch when user opens top-up or after a deposit.

operationId: FiatController_getDepositNumberstag: Fiatpermalink
post/fiat/top-up

Top up fiat account

Auth

No detailed description provided for this operation in the OpenAPI spec.

operationId: FiatController_topUptag: Fiatpermalink
get/fiat/transactions

Endpoint

Auth

No detailed description provided for this operation in the OpenAPI spec.

operationId: FiatController_getFiatTransactionstag: Fiatpermalink
post/fiat/transfer

P2P transfer (passkey, 2FA, or PIN required)

Auth

No detailed description provided for this operation in the OpenAPI spec.

operationId: FiatController_p2pTransfertag: Fiatpermalink
post/fiat/withdraw

Request withdrawal (passkey, 2FA, or PIN required)

Auth

No detailed description provided for this operation in the OpenAPI spec.

operationId: FiatController_withdrawtag: Fiatpermalink
get/fiat/withdrawal-beneficiaries

List saved withdrawal beneficiaries (payee numbers)

Auth

Fetch on login and persist in cache; refetch when user opens withdraw or after a withdrawal.

operationId: FiatController_getWithdrawalBeneficiariestag: Fiatpermalink