Simulate a credit to your account

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

A simulated incoming transfer to your account.

double
required
0 to 1000000

Amount credited, at most 2 decimals.

string
required
length between 3 and 3

Currency credited (ISO 4217).

string
enum
Defaults to wire

Rail the funds arrive by.

string
length ≤ 100

Reference of the transfer, such as an invoice number. Defaults to a generated SIM reference. Each reference is credited once.

Headers
string

Unique key to prevent duplicate processing

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json