SaltEdge¶

Open banking for every business. Harness the power of open banking. Embrace the future of finance

Set up Account Provider account¶

Step 1: Create Provider account¶

To create an account send connection request at the saltedge.com/contact_us 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:

App ID
Secret
Public key
- you need to take it from the provider's documentation docs.saltedge.com/v6/#callbacks-request-identification
Private key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

App ID
Secret
Public key
Private key

Success

You have connected SaltEdge Provider account!

Information for Merchant¶

To initiate a payment using the SaltEdge provider, the following requirements must be met:

Creditor Information

All creditor fields in the payment route provider options must be populated with the merchant’s details (e.g., name, IBAN, address). This information is displayed in the SaltEdge payment widget and used for payment processing.

Customer Details

The merchant must provide the customer’s email address and IP address when creating the payment invoice request. These fields are mandatory and required by the provider.

Customer Flow

After redirection, the customer will:

Select their bank via the SaltEdge payment widget
Authenticate using their online banking credentials
Confirm and complete the payment

After the payment is processed, the customer will be redirected back to the merchant's website.

⚠️ Ensure all required fields are correctly populated to avoid errors during the payment process.

API examples:¶

Minimum data set to create a payment invoices for sepa_transfer_eur_hpp service¶

PAYMENT
sepa_transfer_eur_hpp

POST /api/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "aec25c00-d058-48bb-b122-4ed8b9353fdb",
      "service": "sepa_transfer_eur_hpp",
      "currency": "EUR",
      "amount": 1,
      "test_mode": false,
      "customer": {
        "reference_id": "12345",
        "email": "[email protected]",
        "metadata": {
          "ip": "0.0.0.0"
        }
      }
    }
  }
}

Minimum data set to create a payment invoices for sepa_transfer_instant_eur_hpp service¶

PAYMENT
sepa_transfer_instant_eur_hpp

POST /api/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "aec25c00-d058-48bb-b122-4ed8b9353fdb",
      "service": "sepa_transfer_instant_eur_hpp",
      "currency": "EUR",
      "amount": 1,
      "test_mode": false,
      "customer": {
        "reference_id": "12345",
        "email": "[email protected]",
        "metadata": {
          "ip": "0.0.0.0"
        }
      }
    }
  }
}

Maximum data set to create a payment invoices for sepa_transfer_eur_hpp service¶

PAYMENT
sepa_transfer_instant_eur_hpp

POST /api/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "ad487600-7360-42b7-abd6-1d9616a9353a",
      "service": "sepa_transfer_instant_eur_hpp",
      "currency": "EUR",
      "amount": 1,
      "test_mode": false,
      "customer": {
        "reference_id": "test",
        "name": "Test Test",
        "email": "[email protected]",
        "date_of_birth": "2025-05-01",
        "address": {
          "full_address": "Adresss",
          "country": "PL",
          "post_code": "12345"
        },
        "metadata": {
          "ip": "0.0.0.0"
        }
      },
      "service_fields": {
        "account": "DE84100110012612443333"
      }
    }
  }
}

PAYMENT
sepa_transfer_eur_hpp

POST /api/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "ad487600-7360-42b7-abd6-1d9616a9353a",
      "service": "sepa_transfer_eur_hpp",
      "currency": "EUR",
      "amount": 1,
      "test_mode": false,
      "customer": {
        "reference_id": "test",
        "name": "Test Test",
        "email": "[email protected]",
        "date_of_birth": "2025-05-01",
        "address": {
          "full_address": "Adresss",
          "country": "PL",
          "post_code": "12345"
        },
        "metadata": {
          "ip": "0.0.0.0"
        }
      },
      "service_fields": {
        "account": "DE84100110012612443333"
      }
    }
  }
}

Provider Options¶

Provider_Options

CHARGE_BEARER (mandatory option)
Determines who will be charged the commission if any bank fees apply (e.g., for SEPA INSTANT transfers):
- Debtor – 100% of the commission is paid by the payer (typically the end customer)
- Creditor – 100% of the commission is paid by the payee (typically the merchant)
- Shared – the commission is split equally between the payer and the payee

Question

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