Finmo integration

Create Customer

Create a real production Finmo customer profile containing personal or company identity data. This stores PII, mutates production, and may start identity-verification or other compliance workflows, but does not itself move money. Confirm that the customer has authorized this processing and supply t…

Create Payin

Create a real production payin that can collect money from a customer and credit a customer or merchant wallet. This has real financial effects. First call FINMO_LIST_PAYIN_METHODS and FINMO_GET_PAYIN_METHOD_REQUIREMENTS, then supply exactly the selected method's required parameters. Reuse the same…

Create Payout

Send real production funds from a Finmo wallet to a beneficiary. This reserves and can irreversibly transfer money. First call FINMO_LIST_PAYOUT_METHODS and FINMO_GET_PAYOUT_METHOD_REQUIREMENTS, verify the beneficiary and available wallet balance, and obtain approval for the exact destination and a…

Create Payout Beneficiary

Create a real payout beneficiary in the connected Finmo production account. This does not move money, but Finmo stores the supplied sensitive bank, proxy, identity, and contact data and the record can enable later payouts. First call FINMO_LIST_PAYOUT_METHODS and FINMO_GET_PAYOUT_METHOD_REQUIREMENT…

Create Refund

Issue a real production full refund for a completed Finmo payin. This moves real money, debits or holds funds in the payin wallet, may incur fees, and may be irreversible. Before calling, verify the payin is refundable and that the full refund is intended. Use a unique idempotency_key and reuse it …

Get Payin Method Requirements

Return the dynamic required fields, validation regexes, limits, instructions, and capabilities for one Finmo payin method. Call this immediately before constructing a payin request.

Get Payment

Get one payin, payout, or refund by its Finmo reference ID. Use this after an ambiguous timeout before retrying a money-moving request with the same idempotency key.

Get Payout Method Requirements

Return the dynamic payout, beneficiary, and sender field requirements for one Finmo payout method. Use it before creating a beneficiary or moving money.

Get Wallet

Get one wallet and its currency accounts, including actual and available balances. Reading balances is sensitive but does not move funds.

List Customers

List one page of individual or company customer profiles and wallet-readiness state. Returns a continuation cursor when more customers are available.

List Payin Methods

List one page of enabled ways to collect money for a country and currency, with a continuation cursor when more results exist. Use FINMO_GET_PAYIN_METHOD_REQUIREMENTS before creating a payin because required fields vary by method.

List Payins

List inbound payment attempts with status, method, customer, wallet, and time filters. Returns one page and a continuation cursor.