Skip to content

Logo

Nexpay

A banking partner that puts your business first

Supports in this guide: Payouts

Provider website: paynexpay.com

What you need to do for start processing transactions (brief summary)

  1. Get your credentials (from Nexpay)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from Nexpay

Contact your Nexpay account manager to get your account verified and receive the following credentials.

  • External ID -> Corefy field external_id -> any unique value you choose; used internally by Corefy to identify this connection.
  • API Key -> Corefy field api_key.
  • Message Secret -> Corefy field message_secret -> used to sign every request.
  • Transaction Secret -> Corefy field transaction_secret -> used to sign every payout's transaction data specifically.

Important

Confirm with your account manager whether IP whitelisting is required on Nexpay's side. If so, provide the IP addresses from the Corefy list.

Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open Nexpay in the provider directory and press Connect at Nexpay Provider Overview page in the New connection section. Choose Provider account.

Step 2 - Fill in fields and select settings

  • External ID
  • API Key
  • Message Secret
  • Transaction Secret
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Nexpay Provider account!

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds via SEPA bank transfer.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0dde9e79-2c64-4703-adaf-93d710633401",
      "service": "bank_transfer_eur",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123"
      },
      "fields": {
        "account_number": "GB97BARC20031877565489",
        "beneficiary_full_name": "John Smith"
      }
    }
  }
}

Important

customer.reference_id, fields.account_number (IBAN), and fields.beneficiary_full_name are all required - the payout is rejected ("Missing required fields") if any of them is missing.

Payout - MAX

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "3c6d2f8e-8a2a-4e7a-9b1a-2f6a7b9c0d1e",
      "service": "bank_transfer_eur",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123"
      },
      "fields": {
        "account_number": "GB97BARC20031877565489",
        "beneficiary_full_name": "John Smith"
      }
    }
  }
}

There are no further optional fields beyond the MIN example for this flow.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

No Options are configured for this connector.

Constants (fallback fields)

Constants are static values that Corefy can send to the provider instead of dynamic data from your API request, when those fields are missing in the request. Configured for the bank_transfer_eur service only.

Priority (predictable rule): 1. If a value is present in the request -> Corefy uses the request value 2. Else if the constant is set -> Corefy uses the constant 3. Else -> provider may reject the request or apply its defaults (depends on provider)

Currently available constants (constant -> Corefy API field)

  • COMMISSION_ACCOUNT -> an optional IBAN of a separate account to deduct Nexpay's own commission from; if not set, this field is simply left out of the request to Nexpay.

Additional info

  1. No callback mechanism - Nexpay doesn't send asynchronous callback notifications for this connector; Corefy checks payout status via reconciliation (active status requests) instead.
  2. No payments - this connector only supports payouts through Corefy, not incoming payments.

FAQ / Troubleshooting

  • Payout rejected with "Missing required fields" -> make sure customer.reference_id, fields.account_number, and fields.beneficiary_full_name are all present
  • Invalid credentials / auth error -> verify API Key/Message Secret/Transaction Secret for the selected environment
  • Currency or service is not supported -> confirm allowed currencies/features in your Nexpay account and in Corefy

Question

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