Skip to content

Logo

VelPay

VelPay - International Payment Platform. VelPay is an ecosystem for receiving/paying and exchanging funds for your business. We provide a secure platform for online payments and the ability to make payments in one click.

Supports in this guide: Payments

Provider website: velpay.io

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

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

Prerequisites: get from VelPay

Send a connection request at velpay.io/#contact or contact your VelPay account manager directly to get your account verified and receive the following credentials.

  • Public key -> Corefy field public_key.
  • Private key -> Corefy field private_key.

EUR, KZT.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Public key
  • Private key
  • Currency / Features -> choose values available for your account (EUR, KZT)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected VelPay 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.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "b00792c4-2c53-4292-9a47-5a76376ef69e",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 100
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "0db4a1ad-e583-43c1-bc97-f9322580d4ac",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 100,
      "description": "Order #12345",
      "customer": {
        "reference_id": "9a2f6d0d-bda7-4e1f-8a02-5b6c7d8e9f0a",
        "name": "John Wick",
        "email": "john@example.com"
      }
    }
  }
}

Important

  • payer_name/payer_last_name sent to VelPay are derived from the card's own embossed cardholder name, not from customer.name.
  • customer.email (or the EMAIL Constant) is sent as the payer email; if neither is set, 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

Options

  • ignore_callback -> optional, boolean - for cascading to work correctly, ignores VelPay's asynchronous callback and relies only on an active status request to finalize the payment.

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.

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)

  • EMAIL -> customer.email

Refunds

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

Additional info

  1. Active reconciliation is available - both the asynchronous callback and an active status request can finalize the payment, unless ignore_callback is enabled.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the public/private key pair for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your VelPay account and in Corefy - only EUR and KZT are available
  • Refund fails with multiple attempts -> only one refund per payment is allowed

Question

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