Skip to content

Logo

Northpeak Pay

Be In Control Of Your Financial Assets And Stay On Peak

Supports in this guide: Payments

Provider website: northpeakpay.com

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

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

Prerequisites: get from Northpeak Pay

Send a connection request at northpeakpay.com/contacts or contact your Northpeak Pay manager directly to get your account verified and receive the following credentials.

  • API key -> Corefy field api_key.
  • API type -> Corefy field api_type -> server to server or direct post; confirm with your Northpeak Pay manager which one applies to your account.
  • S2S token (optional) -> Corefy field s2s_token -> only needed when API type is server to server.
  • Brand ID -> Corefy field brand_id.
  • Webhook public key (optional) -> Corefy field webhook_public_key -> uploaded as a file; used to verify webhook/callback signatures.
  • API URL (optional) -> Corefy field api_url -> leave as default unless your account manager tells you otherwise.

EUR only.

Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

Open Northpeak Pay in the provider directory and press Connect at Northpeak Pay Provider Overview page in the New connection section.

Step 2 - Fill in fields and select settings

  • API key
  • API type
  • S2S token (optional)
  • Brand ID
  • Webhook public key (optional)
  • API URL (optional)

Success

You have connected Northpeak Pay H2H Merchant account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice; card data itself is collected and submitted separately by Corefy's checkout/SDK layer, not as part of this request. CVV is always required. Northpeak Pay may return a 3D Secure challenge redirect depending on the card.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "69729ec3-1eeb-44b4-b7b2-d0b29d3c9f81",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 5
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "877a78a1-a29b-4e90-902c-79d94ba1cff7",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 5,
      "customer": {
        "reference_id": "9b8c7d6e-5f4a-4b3c-8d02-1e2f3a4b5c6d",
        "email": "test@example.com"
      }
    }
  }
}

Important

No Constants or Options are configured for this connector - if a customer field is missing, it's simply not sent.

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

Refunds

Northpeak Pay supports partial refunds, but only one refund per payment (no multiple partial refunds against the same payment).

Additional info

  1. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the API key, API type, Brand ID (and S2S token, if API type is server to server)
  • Currency or service is not supported -> confirm allowed currencies/features in your Northpeak Pay account and in Corefy - only EUR is available
  • Refund fails with multiple attempts -> only one refund per payment is allowed
  • Not sure which API type to use? -> confirm with your Northpeak Pay account manager whether your account is set up for server to server or direct post

Question

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