Skip to content

Logo

MassPay

Global Payments. Local Preferences.

Website: masspay.io

Set up Account Provider account

Step 1: Create Provider account

To create an account send connection request at the masspay.io or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

  • masspay__api_key → API Key
  • masspay__webhook_secret → Webhook Secret
  • masspay__test_mode → Test Mode

Connect Provider Account

Step 1. Connect Provider account at the Corefy Dashboard

Press Connect at MassPay Provider Overview page in 'New connection' section and choose Provider account option to open Connection form.

Connect

Enter credentials:

  • API Key
  • Webhook Secret
  • Test Mode

Success

You have connected MassPay Provider account!

API examples:

Minimum data set to create a payment invoices for payment_card_usd service

PAYOUT
POST /api/payout-invoices HTTP/1.0
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_usd",
      "currency": "USD",
      "amount": 100,
      "reference_id": "2dc51bcc-65a9-4fed-802b-30b427a40e69",
      "context": {
        "card": {
          "exp_year": "30",
          "exp_month": "12"
        }
      },
      "customer": {
        "reference_id": "8a033b30-f7e6-451d-9b58-4100eec1884c",
        "name": "John Doe",
        "email": "[email protected]",
        "date_of_birth": "2001-02-01",
        "address": {
          "full_address": "Some street 200",
          "country": "US",
          "city": "New York"
        }
      },
      "test_mode": true,
      "fields": {
        "card_number": "411111******1111",
        "document_id": "123456789",
        "beneficiary_postcode": "77777"
      }
    }
  }
}

Maximum data set to create a payment invoices for payment_card_usd service

PAYOUT
POST /api/payout-invoices HTTP/1.0
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "payment_card_usd",
      "currency": "USD",
      "amount": 100,
      "reference_id": "2dc51bcc-65a9-4fed-802b-30b427a40e69",
      "context": {
        "card": {
          "exp_year": "30",
          "exp_month": "12"
        }
      },
      "customer": {
        "reference_id": "8a033b30-f7e6-451d-9b58-4100eec1884c",
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "+13123456789",
        "date_of_birth": "2001-02-01",
        "address": {
          "full_address": "Some street 200",
          "country": "US",
          "region": "NY",
          "city": "New York",
          "post_code":"77777"
        }
      },
      "test_mode": true,
      "fields": {
        "card_number": "411111******1111",
        "document_id": "123456789",
        "beneficiary_postcode": "77777"
      }
    }
  }
}

Minimum data set to create a payout invoices for ach_usd service

PAYOUT
POST /api/payout-invoices HTTP/1.0
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "ach_usd",
      "currency": "USD",
      "amount": 100,
      "reference_id": "2dc51bcc-65a9-4fed-802b-30b427a40e69",
      "customer": {
        "reference_id": "8a033b30-f7e6-451d-9b58-4100eec1884c",
        "name": "John Doe",
        "email": "[email protected]",
        "date_of_birth": "2001-02-01",
        "address": {
          "full_address": "Some street 200",
          "country": "US",
          "city": "New York"
        }
      },
      "test_mode": true,
      "fields": {
        "account_number": "13849131",
        "routing_number": "021000021",
        "account_type": "Checking",
        "beneficiary_document_id": "123456789"
      }
    }
  }
}

Minimum data set to create a payout invoices for interac_cad service

PAYOUT
POST /api/payout-invoices HTTP/1.0
{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "service": "interac_cad",
      "currency": "CAD",
      "amount": 100,
      "reference_id": "2dc51bcc-65a9-4fed-802b-30b427a40e69",
      "customer": {
        "reference_id": "8a033b30-f7e6-451d-9b58-4100eec1884c",
        "name": "John Doe",
        "email": "[email protected]",
        "date_of_birth": "2001-02-01",
        "address": {
          "full_address": "Some street 200",
          "country": "US",
          "city": "New York"
        }
      },
      "test_mode": true,
      "fields": {
        "account_number":"[email protected]"
      }
    }
  }
}

Constants

Constants

If some parameters are not sent in the transaction creation request, they will take the values from the set constants.

Here is a list of constants with their corresponding parameters:

  • COUNTRY → customer address [country]
  • REGION → customer address [region]
  • CITY → customer address [city]
  • ADDRESS → customer address [full_address]
  • POST_CODE → customer address [post_code]
  • DATE_OF_BIRTH → customer [date_of_birth]

Question

"Still looking for help connecting your MassPay account?" Please contact our support team!