Nuvei (SafeCharge)¶

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

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¶

1. Generate CSR and key to it, upload CSR to "Update".
2. Then to get CRT certificate, click Generate Certificate, download it → Client Certificate
3. 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
• 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

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
      }
    }
  }
}