MatrixPay
Smarter Payments. Start Here. MatrixPay is a modern, white-label payment gateway designed for fintechs, PSPs, ISOs, and ambitious merchants. Fast, flexible, and fully customizable.
Website: matrixpay.eu
Set up H2H merchant account
Step 1: Create Merchant Account
To create an account send connection request at the matrixpay.eu → Get in Touch 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:
- matrixpay__merchant_id → Merchant ID
- matrixpay__secret_key → Secret Key
- matrixpay__test_mode → Test Mode
- matrixpay__currency → choose currency (You can set these parameters according to available currencies and features for your MatrixPay wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)
Connect Merchant Account
Step 1. Connect H2H account at the Corefy Dashboard
Press Connect at MatrixPay Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.
Enter credentials:
- Merchant ID
- Secret Key
- Test Mode → true/false
Success
You have connected MatrixPay H2H merchant account!
Set up Provider account
Step 1: Create Provider account
To create an account send connection request at the matrixpay.eu → Get in Touch 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:
- matrixpay__merchant_id → Merchant ID
- matrixpay__secret_key → Secret Key
- matrixpay__test_mode → Test Mode
Connect Provider Account
Step 1. Connect Provider account at the Corefy Dashboard
Press Connect at MatrixPay Provider Overview page in 'New connection' section and choose Provider account option to open Connection form.
Enter credentials:
- Merchant ID
- Secret Key
- Test Mode → true/false
Success
You have connected MatrixPay Provider account!
API examples:
Minimum data set to create a payment invoices for payment_card_eur_hpp service
SALE
1. Create Invoice:
Send a POST request to /api/payment-invoices with the required customer and
payment details for the payment_card_eur_hpp service on Paycore.
POST /api/payment-invoices HTTP/1.1
{
"data": {
"type": "payment-invoice",
"attributes": {
"reference_id": "fd31414b-17e1-44aa-89b3-93d5c9fb5b52",
"service": "payment_card_eur_hpp",
"currency": "EUR",
"amount": 10,
"test_mode": true,
"customer": {
"reference_id": "asd",
"name": "Max Mustermann",
"email": "[email protected]",
"phone": "+4912345678",
"date_of_birth": "1997-06-18",
"first_name": "Max",
"surname": "Mustermann",
"address": {
"full_address": "Landsberger Allee 93",
"country": "AR",
"region": "Freistaat Bayern",
"city": "München",
"post_code": "80604"
}
}
}
}
}
2. Extract Token:
From the response, extract the token located at flow_data.metadata.token.
3. Authorize Sale:
Use the extracted token as the value of the Authorization header in the next
request to /payment/sale on Cardgate.
POST /payment/sale HTTP/1.1
Authorization: Bearer <flow_data.metadata.token>
{
"data": {
"type": "sale-operation",
"attributes": {
"card_number": "4242424242424242",
"card_holder": "Card Holder",
"cvv": "123",
"exp_month": "06",
"exp_year": "27",
"browser_info": {
"browser_accept_header": "application/json, text/plain, */*",
"browser_color_depth": "24",
"browser_ip": "195.114.222.200",
"browser_java_enabled": false,
"browser_language": "uk",
"browser_screen_height": "100",
"browser_screen_width": "100",
"browser_tz": "-120",
"browser_user_agent": "Mozilla/5.0 (Linux; Android 9; Redmi Note 5 Build/PKQ1.180904.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/99.0.4844.58 Mobile Safari/537.36 trill_2022106050 JsSdk/1.0 NetType/WIFI Channel/googleplay AppName/musical_ly app_version/21.6.5 ByteLocale/uk-UA ByteFullLocale/uk-UA Region/UA BytedanceWebview/d8a21c6",
"device_channel": "1",
"window_height": "100",
"window_width": "100"
}
}
}
}
Minimum data set to create a payment invoices for payment_card_eur_hpp service
PAYMENT
POST /api/payment-invoices HTTP/1.1
{
"data":{
"type":"payment-invoices",
"attributes":{
"test_mode":true,
"reference_id":"1747753828",
"currency":"EUR",
"amount":10,
"service":"payment_card_eur_hpp",
"customer":{
"reference_id":"123_231",
"email":"[email protected]",
"name":"Olivia Marie Thompson",
"phone":"+447912345670",
"address":{
"country":"GB",
"region":"Birmingham",
"city":"Birmingham",
"full_address":"45 Oak Lane",
"post_code":"B12 9YZ"
},
"date_of_birth":"1988-07-15"
},
}
}
}
Maximum data set to create a payment invoices for payment_card_eur_hpp service
PAYMENT
POST /api/payment-invoices HTTP/1.1
{
"data":{
"type":"payment-invoices",
"attributes":{
"test_mode":true,
"reference_id":"1747752612",
"currency":"EUR",
"amount":10,
"service":"payment_card_eur_hpp",
"customer":{
"reference_id":"123_231",
"email":"[email protected]",
"name":"Olivia Marie Thompson",
"phone":"+447912345670",
"address":{
"country":"GB",
"region":"Birmingham",
"city":"Birmingham",
"full_address":"45 Oak Lane",
"post_code":"B12 9YZ"
},
"date_of_birth":"1988-07-15",
"individual_tax_id":"1234567890",
"passport_number":"456789"
},
}
}
}
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:
- FIRST_NAME → customer [first_name]
- LAST_NAME → customer [last_name]
- DATE_OF_BIRTH → customer [date_of_birth]
- FULL_ADDRESS → customer [address] [full_address]
- CITY → customer [address] [city]
- REGION → customer [address] [region]
- POST_CODE → customer [address] [post_code]
- COUNTRY → customer [address] [country]
- EMAIL → customer [email]
- PHONE → customer [phone]
- INDIVIDUAL_TAX_ID → customer [individual_tax_id]
- PASSPORT_NUMBER → customer [passport_number] ?? constants [passport_number]
- REFERENCE_ID → constant [reference_id]
Question
"Still looking for help connecting your MatrixPay account?" Please contact our support team!