Nuvei (SafeCharge)
Payments designed to accelerate your business
Website: www.nuvei.com
Login: nuvei.com
Follow the guidance for setting up a connection with Nuvei (SafeCharge) payment service provider.
Set up Account H2H merchant account
Step 1: Create Merchant Account
To create an account send connection request at the www.nuvei.com/contact 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:
- safecharge__merchant_id → Merchant ID
- safecharge__merchant_site_id → Site ID
- safecharge__merchant_secret_key → Secret key
- safecharge__merchant_test_mode → Test mode
- safecharge__save_instant_token → Save Instant Token
- safecharge__dynamic_descriptor → Dynamic descriptor
- safecharge__pay_fac_prefix → PayFac prefix
- safecharge__save_oct_token → Save OCT token
- safecharge__currency → choose currency (You can set these parameters according to available currencies and features for your SafeCharge 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 SafeCharge Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.
Enter credentials:
- Merchant ID
- Site ID
- Secret key
- Test Mode → true/false
- Save Instant Token
- Dynamic descriptor
- PayFac prefix
- Save OCT token
Success
You have connected SafeCharge H2H merchant account!
Set up Account Provider account
Step 1: Create Provider account
To create an account send connection request at the www.nuvei.com/contact or contact manager directly. Submit the required documents to verify your account and gain access.
Generating credentials in your personal account:
Account Number
Private party id - iss
Corporate Party id - sub
Authorization public key id - Key Id
Signing public key id
Authorization private key (generated from the Public key that was thrown here)
Signing private key (generated from the Public key that was thrown here)
Certificates
- Generate CSR and key to it, upload CSR to "Update".
- Then to get CRT certificate, click Generate Certificate, download it → Client Certificate
- Upload the key that was generated with CSR file (item 1) to -> Client Private Key
Step 2: Get required credentials
Instructions for obtaining certificates
Credentials that have to be issued:
- safecharge__use_corporate_api → Use Corporate API
- this toggle switches between using the old and new API
- if the option is ON, then the new API version is used
- if the option is OFF, then the old API version is used
- this toggle switches between using the old and new API
- safecharge__id → ID
- safecharge__site_id → Site ID
- if the Use Corporate API option = ON, then Site ID is not required
- safecharge__secret_key → Secret Key
- safecharge__account_number → Account Number
- safecharge__private_party_id → Private Party Id
- safecharge__corporate_party_id → Corporate Party Id
- safecharge__auth_public_key_id → Authorization public key id
- safecharge__auth_private_key → Authorization private key
- safecharge__sign_public_key_id → Signing public key id
- safecharge__sign_private_key → Signing private key
- safecharge__client_certificate → Client Certificate
- safecharge__client_private_key → Client Private Key
Connect Provider Account
Step 1. Connect Provider account at the Corefy Dashboard
Press Connect at SafeCharge Provider Overview page in 'New connection' section and choose Provider account option to open Connection form.
Enter credentials:
- ID
- Site ID
- Secret Key
- Account Number
- Private Party Id
- Corporate Party Id
- Authorization public key id
- Authorization private key
- Signing public key id
- Signing private key
- Client Certificate
- Client Private Key
- Test Mode → true/false
Success
You have connected SafeCharge Provider account!
API examples:
Minimum data set = Maximum data set to create a payout invoices for sepa_transfer_eur service
PAYOUT
SEPA
POST /api/commerce/payout-invoices HTTP/1.0
{
"data":{
"type":"payout-invoice",
"attributes":{
"service":"sepa_transfer_eur",
"commerce_account":"Hello World",
"currency":"EUR",
"amount":12.5,
"test_mode":true,
"reference_id":"96e0dcd0-5d9b-41a3-8065-0d677c57127e",
"fields":{
"account_number":"test test",
"beneficiary_first_name":"John",
"beneficiary_last_name":"Doe"
},
"options":{
"attempts_limit":0,
"split_mode":false,
"allow_partially":false,
"auto_process":false
}
}
}
}
Maximum data set to create a payout invoices for bank_transfer_eur service
PAYOUT
Bank transfer
POST /api/commerce/payout-invoices HTTP/1.0
{
"data":{
"type":"payout-invoice",
"attributes":{
"service":"bank_transfer_eur",
"commerce_account":"Hello World",
"currency":"EUR",
"amount":15,
"test_mode":true,
"reference_id":"377bc4a9-3199-404a-89f0-da67116524b5",
"fields":{
"account_number":"test test",
"bank_code":"ITAUBRSP",
"bank_name":"Banco do Brasil",
"bank_address":"Avenida Paulista, 1234, Sao Paulo, SP, Brazil",
"beneficiary_name":"Carlos",
"beneficiary_lastname":"Silva"
},
"options":{
"attempts_limit":0,
"split_mode":false,
"allow_partially":false,
"auto_process":false
}
}
}
}
Question
"Still looking for help connecting your SafeCharge account?" Please contact our support team!