Introduction to MassPay REST API

Overview
Authentication
Idempotent Requests
Versioning
Webhooks
Swimlanes
Error codes
Data Migration
Testing
PCI

MassPay API

Account
Attribute
Card
- Get MassPay card informationget
- Update MassPay card informationput
Catalog
KYC
Load
Payout
Spend Back
- Get history of spend backs by user tokenget
- Initiate a spend back transactionpost
Tax
User
Wallet
Business
- Create a businesspost
- Update businesspatch

Retrieve all available wallets for a user

get https://{environment}.masspay.io/{VERSION}/payout/wallet/{user_token}

This GET endpoint is used to retrieve all available wallets for a provided user token.
You can use this endpoint to obtain information about the wallets associated with the provided user token.
To use this endpoint, you need to provide the user_token as a required parameter in the URL Path.
The response will include a JSON array containing details for each wallet including user_token, balance, currency_code.

URL Expired

The URL for this request expired after 30 days.

Path Params

user_token

string

required

Token representing the user who owns the wallet

Headers

Idempotency-Key

string

Unique key to prevent duplicate processing

Responses

Response body

array of objects

object

user_token

string

required

Token representing the user

token

uuid

required

Token representing the wallet

balance

number

required

The wallet's current balance in USD

currency_code

string

required

The currency wallet balance is stored in. Using ISO 4217 format. In most cases this value will be USD

type

string

required

Type of wallet

MASSPAY_CARD USER_FUNDS

card_type

string

In case type of wallet is MASSPAY_CARD, card_type would be provided with the type of card it is

MASTERCARD VISA AMEX DISCOVER UNIONPAY

last_4

string

In case type of wallet is MASSPAY_CARD, last_4 would be provided with the last four digits of the card

active

boolean

required

An indicator whether the wallet is active. If inactive, can still retrieve historical transactions history

client_paying_fees

boolean

An indicator whether the fees for payouts using this wallet are paid by the client. If false, the user pays the fees

Headers

object

Access-Control-Allow-Origin

string

Response body

object

title

string

Error title.

Bad request.

message

string

required

Error description.

The request was invalid or malformed. Please ensure that the request body conforms to the required format and that all required parameters are included.

code

integer

required

Error code.

400

error

object

reason

string

Reason for error

details

array of strings

Specific details of the cause of the error

details

Headers

object

Access-Control-Allow-Origin

string

Response body

object

title

string

Error title.

Unauthorized.

message

string

required

Error description.

Authentication failed or credentials were not provided. Please ensure that you have provided valid API credentials and that they are authorized to access the MassPay API.

code

integer

required

Error code.

401

Headers

object

Access-Control-Allow-Origin

string

Response body

object

title

string

Error title.

Forbidden.

message

string

required

Error description.

The requested action is not allowed or the API credentials do not have sufficient permissions. Please ensure that the API credentials used for the request have the necessary permissions to perform the requested action.

code

integer

required

Error code.

403

Headers

object

Access-Control-Allow-Origin

string

Response body

object

title

string

Error title.

Not found.

message

string

required

Error description.

The requested resource was not found. Please ensure that the URL for the request is correct and that the requested resource exists.

code

integer

required

Error code.

404

Headers

object

Access-Control-Allow-Origin

string

Response body

object

title

string

Error title.

Method not allowed.

message

string

required

Error description.

The HTTP method used for the request is not supported by the MassPay API. Please ensure that you are using the correct HTTP method (e.g., POST) for the specific MassPay API endpoint.

code

integer

required

Error code.

405

Headers

object

Access-Control-Allow-Origin

string

Response body

object

title

string

Error title.

Internal server error.

message

string

required

Error description.

An unexpected error occurred on the server-side while processing the request. Please try again later or contact support if the issue persists.

code

integer

required

Error code.

500

Headers

object

Access-Control-Allow-Origin

string

Response body

object

title

string

Error title.

Gateway Time-out.

message

string

required

Error description.

The request timed out while waiting for a response from the server. Please try again later or contact support if the issue persists.

code

integer

required

Error code.

500

Headers

object

Access-Control-Allow-Origin

string

Updated 3 months ago

All Users' Transactions history

Get all AutoPayout rules

Did this page help you?

Language

Credentials

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.masspay.io/v1.0.0/payout/wallet/user_token \
3
     --header 'accept: application/json'


xxxxxxxxxx
13
 
1
[
2
  {
3
    "user_token": "usr_ba4275f2-bae1-488d-9d6f-20af1cd83574",
4
    "token": "usr_wlt_123e4567-e89b-12d3-a456-426614174000",
5
    "balance": 100.5,
6
    "currency_code": "USD",
7
    "type": "USER_FUNDS",
8
    "card_type": "VISA",
9
    "last_4": "1234",
10
    "active": true,
11
    "client_paying_fees": true
12
  }
13
]

Updated 3 months ago

All Users' Transactions history

Get all AutoPayout rules

Did this page help you?

Headers

Response

Access-Control-Allow-Origin

Introduction to MassPay REST API
Overview
Authentication
Idempotent Requests
Versioning
Webhooks
Swimlanes
Error codes
Data Migration
Testing
PCI

MassPay API
Account
Get top up transaction detailsget
List account topup funding instrumentsget
Add new funding instrumentpost
Top up account balancepost
Get certified account statementget
Delete a webhook configurationdelete
Get webhooksget
Create a webhook configurationpost
Get account configurationget
Get current available balanceget
Attribute
Get user attributes for destination_tokenget
Store user attributespost
Get all stored user attributesget
Card
Update MassPay card informationput
Get MassPay card informationget
Catalog
Get available user agreementsoptns
Get user agreementget
Returns provided serviceget
Returns list of alternative service to a provided serviceget
Gets a list of Companies and their service offerings for the given country code.get
Gets a list of Companies and their best service offerings for the given country code.get
Gets a list of countries where services offered.get
KYC
Link a Ondato session idput
Link a Veriff session idput
Get a Veriff session linkget
Get all KYC sessionsget
Upload ID photospost
Attributes velocity checkpost
Load
Reverse a user loaddelete
Resend load notificationput
Get history of loads by user tokenget
Initiate a load transactionpost
Resend balance notificationput
Payout
Get transaction confirmation detailspatch
Get status of a payout by payout tokenget
Commit payout transactionput
Get history of payouts by user tokenget
Initiate a payout transactionpost
Spend Back
Initiate a spend back transactionpost
Get history of spend backs by user tokenget
Tax
Get all tax interview sessionsget
Get link for tax interviewget
Get list of users' annual balanceget
User
All Users' Transactions historyget
Transactions historyget
Lookup an existing userget
Updated userput
Get user by user tokenget
Create a userpost
Wallet
Delete AutoPayout ruledelete
Add AutoPayout rulepost
Get all AutoPayout rulesget
Retrieve all available wallets for a userget
Business
Update businesspatch
Create a businesspost

200Successful operation.

400Bad request.

401Unauthorized.

403Forbidden.

404Not found.

405Method Not Allowed.

500Internal server error.

504Gateway Time-out.