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 Account 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¶
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]
Question
"Still looking for help connecting your MatrixPay account?" Please contact our support team!