Introduction to MassPay REST API

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

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

Introduction to MassPay REST API

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

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

Get transaction confirmation details

patch https://{environment}.masspay.io/{VERSION}/payout/{user_token}/{payout_token}

This PATCH endpoint is used to obtain a PDF document with all the details of a payout transaction for a user with the specified token and payout token.
You can use this endpoint to obtain confirmation details about a specific payout transaction.
To use this endpoint, you need to provide the user_token and payout_token in the URL Path.
The response will include a PDF document containing all the details of the payout transaction.

URL Expired

The URL for this request expired after 30 days.

Path Params

user_token

string

required

Token representing the user to pay out

payout_token

string

required

Token representing the trsanaction. Retrieved from /payout/{user_token}

Headers

Idempotency-Key

string

Unique key to prevent duplicate processing

Responses

Response body

object

content

string

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.

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 about 1 month ago

Get status of a payout by payout token

Spend Back

Did this page help you?

Language

Credentials

URL


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


xxxxxxxxxx
 
1
{
2
  "content": "Base64;"
3
}

Updated about 1 month ago

Get status of a payout by payout token

Spend Back

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

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
Update webhook URLput
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 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

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

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
Update webhook URLput
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 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

200OK

400Bad request.

401Unauthorized.

403Forbidden.

404Not found.

500Internal server error.

504Gateway Time-out.