TerraPay: balances, prefunding and reporting
TerraPay is a cross-border payments network that lets money transfer operators, banks, wallets and platforms send payouts to mobile wallets, bank accounts and cards in more than 150 countries through one integration. Send partners prefund ledger accounts with TerraPay in a prefunding currency, can fund in stablecoins where regulators allow, and track balances with the Ledger Balance API and the Statements API.
What TerraPay does
- TerraPay offers three services to sending partners: Remit to Mobile, Remit to Bank and Remit to Card. source
- Its API supports B2B, B2P, P2B and P2P transactions. source
- Send partners integrate through TerraPay's GSMA API or its web-based ASAP interface. source
- Banks can use their existing Swift connectivity, or connect by API, to send funds into digital wallets and bank accounts through TerraPay. source
- Partners are onboarded after an NDA, a contract and due diligence, and then receive developer portal, sandbox, UAT and live credentials. source
- TerraPay serves money transfer organisations, wallets, banks and financial institutions, and platforms and marketplaces. source
Coverage
- TerraPay states direct integrations with banks, wallets and payment systems across 150+ countries (network page, as of October 2026). source
- The network page lists receive markets across APAC, the Americas, Africa, MENA and Europe, showing wallet, bank and card payout availability and currency for each. source
- African markets listed with both wallet and bank payout include Nigeria (NGN), Ghana (GHS), Kenya (KES), Uganda (UGX), Tanzania (TZS), Rwanda (RWF), Zambia (ZMW), Senegal (XOF) and Cameroon (XAF). source
- Some markets pay out in USD to banks only, for example Egypt (EGP for wallets and banks, USD for banks) and the Philippines (PHP, with USD for banks). source
- TerraPay provides Get Bank List and Get Wallet List APIs per destination country so senders can confirm active endpoints. source
How funds are held and prefunded
- The Corridor Quotation API returns FX rates for the prefunding currency corridors that are active for the partner, using the URI /quotations/{prefunding_currency}. source
- A prefunding currency code is mandatory on corridor quotation requests (a currency code, or USD/ALL). source
- Partner balances are held in ledger accounts per currency; the documented example shows ledgers such as TL-TERRAPAY-US-SENDER-USD and TL-TERRAPAY-NG-SENDER-NGN. source
- In the Statements API, a LIQUIDITY entry is a funding transaction in which transferred funds are credited to the partner's account. source
- Since October 2025, with Fipto, TerraPay clients can fund directly in stablecoins and payout partners can receive them where regulators allow; TerraPay says this has reduced prefunding requirements. source
How to see your TerraPay balance
| Channel | What it gives you | Source |
|---|---|---|
| API | Ledger Balance API: GET /eig/gsma/accounts/all/balance_v1 returns every ledger with currency, currentBalance, account name and status; GET /eig/gsma/accounts/{currency}/balance_v1 returns ledgers for one currency. | source |
| statement file | Statements API: GET /PartnerPortalReports/partnerstatements_v1 with start, end and ledgerBookName returns ledger entries with creationTime, modifiedTime, type, internalRef, externalRef, amount, currency, convertedAmount, convertedCurrency, running balance and message. | source |
| statement file | Statement entry types are TRANSFERRED (debited), REJECTED (not debited), BOUNCED (returned and credited back), LIQUIDITY (funding credit) and PENDING (debited, final status awaited); debits are negative and credits positive. | source |
| webhook | The Status Callback API notifies the partner's configured endpoint (separate UAT and production URLs) when a transaction reaches its final state. | source |
| API | View a Transaction returns the status of a single transaction for follow-up enquiries. | source |
| portal | The TerraPay developer portal shows test scenario status by environment and corridor, and lets partners request corridor activation and reset sandbox and UAT API keys. | source |
Regulation
- Terra Payment Services (Singapore) Pte. Ltd. is listed by the Monetary Authority of Singapore as a Major Payment Institution, including account issuance and cross-border money transfer services. source
- TerraPay was granted a Class B licence by Bank Negara Malaysia in June 2025 for inbound and outbound remittances, B2B payments and wallet services. source
- In July 2025 TerraPay registered with AUSTRAC in Australia as both an Independent Remittance Provider and a Remittance Network Provider. source
- TerraPay's about page states it is registered and regulated across 32 global markets. source
Connecting TerraPay to Polynopsis
Forward TerraPay balance reports and statements to your Polynopsis statement inbox, which parses them into your live position. Polynopsis shows it next to every bank, payout partner, exchange and wallet in one live position.
Frequently asked questions
How do I check my TerraPay prefunded balance by API?
Call the Ledger Balance API at /eig/gsma/accounts/all/balance_v1 for every ledger, or /eig/gsma/accounts/{currency}/balance_v1 for one currency. Each record returns currency, currentBalance, the ledger account name and its status.
How do I see funding credits and payout debits on my TerraPay ledger?
Use the Statements API at /PartnerPortalReports/partnerstatements_v1 with a start time, end time and ledger name. Funding shows as LIQUIDITY, paid transactions as TRANSFERRED, returns as BOUNCED, and every line carries the balance after the entry.
Can I fund TerraPay in stablecoins?
Yes, where regulators allow. Since October 2025 TerraPay, working with Fipto, lets clients fund directly in stablecoins.
Other payout partners and providers
Sources
- TerraPay API Suite · TerraPay
- Get Started · TerraPay
- API References · TerraPay
- TerraPay homepage · TerraPay
- TerraPay Network · TerraPay
- About Us · TerraPay
- Financial Institutions Directory: Terra Payment Services (Singapore) Pte. Ltd. · Monetary Authority of Singapore
- TerraPay Secures Class B License from Bank Negara Malaysia · TerraPay
- TerraPay Secures AUSTRAC Registration · TerraPay
- TerraPay and Fipto launch stablecoin-native flows · TerraPay
Know where all your money is.
Polynopsis gives cross-border payment teams one live position across every bank, payout partner, exchange and wallet, including money in flight, and warns before a corridor runs dry.