This POST endpoint simulates an incoming transfer to your MassPay account and credits your account balance in the currency you choose, and is available in the sandbox environment (staging-api.masspay.io) only; in production it returns a 404.
Provide the amount (above 0 and up to 1,000,000, at most 2 decimals) and the currency (an ISO 4217 code). The credit goes to your primary client wallet in that currency; a wallet is opened for you when you hold none in it yet. Optionally name the method the funds arrive by (wire by default) and a reference.
A balance.credit webhook is sent, and the credit appears in the wallet's ledger like any other account credit. The response returns the credited wallet_token and its new balance; if that balance cannot be read right after the credit, the credit still stands and the response carries a warning in place of wallet_token and balance.
A reference is used once: a second credit with the same reference returns a 409 and credits nothing, so a retried request never credits twice.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||