Mercoa Wallet
The Mercoa Wallet is a payment method designed for business-to-business (B2B) payments within the Mercoa platform. It enables seamless payments between payors and recipients, acting as both a funding source and a payment destination. Only one Mercoa Wallet per entity is supported.
API Reference
Key Features
- Wallet as a Payment Method: The Mercoa Wallet is a top-level payment method, available as both a funding source and as a payment destination on invoices and transactions.
- D+0 Transfer Speed Advantage: Wallet-to-bank payments are D+0 transfers to the vendor (same-day ACH), which is much faster than D+2 or D+3 for ordinary bank-to-bank transfers.
- Payment Method Flexibility: Use as a funding source or payment destination for invoices.
Allowed and Blocked Payment Flows
Wallets can be used in the following payment flows only:
Note: Wallet-to-check or wallet-to-card disbursements aren’t supported.
Example: Creating a Wallet Payment Method
Wallet Balance Management
availableBalance
: The current wallet balance that is immediately available for use. This is updated when the user’s deposited funds settle, when the user withdraws funds, or when a wallet-funded invoice payment is processed.pendingBalance
: The current balance of the incoming wallet funds. This is updated when the user initiates a deposit, and is reset to zero once the deposit settles.
Wallet Onboarding & Usage Guide
Below are the steps to enable, create, fund, and use a Mercoa Wallet as a payment method.
You can perform these actions via the Mercoa dashboard or directly using the Mercoa API.
1. Enable Wallet Payment Methods
In the Mercoa dashboard, enable the “Wallet” option under the Payment Methods section and click Save.
2. Create a Wallet Payment Method
In the Mercoa dashboard, navigate to your entity’s admin page and create a new wallet payment method under Payment Methods.
By API, use the Create Payment Method endpoint:
Note: You may only create one Wallet payment method per entity.
3. Fund the Wallet
Wallets can be funded from a bank account or card. To add funds from a bank account:
4. Check Wallet Balance
You can get your wallet balance using:
5. Withdraw funds
To withdraw funds from your Wallet, update the destinationPaymentMethodId
:
6. Paying Invoices Using Your Mercoa Wallet
Replacing paymentSourceId
with the Wallet ID lets you create invoices with Mercoa Wallet.