Skip to content

Logo

Global Financial Innovations (WinPay)

Integration of Payment Solutions for You and Your Business

Supports in this guide: Payments, Payouts

Provider website: globalfin.uk


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

  1. Choose account type
  2. Get your credentials (from Global Financial Innovations)
  3. Connect in Dashboard
  4. Send an API request

Choose account type

This provider can be connected in different ways (depending on your needs):

  • If you do H2H card payments (card data sent directly) -> choose H2H Merchant account
  • If you do hosted-widget card payments (customer redirected to a payment page) -> choose Merchant account
  • If you do payouts -> choose Provider account

If you're not sure which one to use, confirm with your Corefy account manager.


Prerequisites: get from Global Financial Innovations

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

For H2H Merchant account:

  • API Key -> Corefy field api_key.
  • Secret Key -> Corefy field secret_key.
  • API URL (optional) -> Corefy field api_url -> leave as default unless your account manager tells you otherwise.
  • Send Term URL (optional, enabled by default) -> Corefy field send_term_url.

For Merchant account:

  • API Key -> Corefy field api_key.
  • Secret Key -> Corefy field secret_key.
  • API URL (optional) -> Corefy field api_url.

For Provider account:

  • Service ID -> Corefy field service_id.
  • Secret Key -> Corefy field secret_key.
  • Currency -> Corefy field currency -> single-select, choose from the currencies enabled for your account.
  • API URL (optional) -> Corefy field api_url.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

Open Global Financial Innovations in the provider directory and press Connect at Provider Overview page in the New connection section. Choose H2H Merchant account.

Step 2 - Fill in fields and select settings

  • API Key
  • Secret Key
  • API URL (optional)
  • Send Term URL -> (leave enabled unless your account manager tells you to disable it - it controls whether the 3DS return URL is sent at all)
  • Test Mode -> (enable if you are using sandbox credentials)

Choose Currency / Features. RUB, EUR, USD, and KZT are confirmed; check with your Corefy account manager which are enabled for your account.

Success

You have connected Global Financial Innovations 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": "8e3dbbb0-17af-4c9a-bedb-93bdac6900a2",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567"
      }
    }
  }
}

customer.email/customer.phone are optional and only used to enrich the sale, they never block it.

Important

Always send a CVV - a sale without one isn't supported in practice for this connector.


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, excludes finalizing the payment from the asynchronous callback; Corefy then relies only on an active status request (reconciliation) to finalize it.

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)

  • LANGUAGE -> checkout/3DS page language - EN, UK, or RU.

Refunds

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


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

Connect Merchant account in Corefy Dashboard

Step 1 - Open connection form

Open Global Financial Innovations in the provider directory and press Connect at Provider Overview page in the New connection section. Choose Merchant account.

Step 2 - Fill in fields and select settings

  • API Key
  • Secret Key
  • API URL (optional)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Global Financial Innovations Merchant account!


First request to Corefy API (MIN)

What it does: creates a payment-invoice and returns a redirect link to a hosted payment page where the customer enters their card details.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8e3dbbb0-17af-4c9a-bedb-93bdac6900a2",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

This connector also supports RUB, USD, UAH, and KZT (use payment_card_<ccy>_hpp as the service code). customer is not used at all on 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 or Constants are configured for this flow.


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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Service ID
  • Secret Key
  • Currency -> single-select
  • API URL (optional)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Global Financial Innovations Provider account!


First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds directly to a card.

Payout - MIN

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0dde9e79-2c64-4703-adaf-93d710633401",
      "service": "payment_card_eur",
      "currency": "EUR",
      "amount": 10,
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Important

fields.card_number is required. This connector also supports card payouts in RUB, UAH, KZT, USD, and GBP (use payment_card_<ccy> as the service code).

Payout - MAX

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "3c6d2f8e-8a2a-4e7a-9b1a-2f6a7b9c0d1e",
      "service": "payment_card_eur",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "phone": "+15551234567",
        "metadata": {
          "date_of_birth": "1990-01-01"
        }
      },
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

customer is entirely optional - name/phone/date of birth, when sent, are only forwarded to the provider as recipient details.


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 or Constants are configured for this flow.


Additional info

  1. Callback routing is dedicated for H2H payments - the callback endpoint is fixed at /winpay/callback; nothing for you to set up on this side, it's configured on Corefy's end.

  2. "H2H Merchant account" and "Merchant account" are genuinely different flows on this connector, not just a naming difference - H2H sends card data directly through Corefy's checkout/SDK layer, while Merchant account always redirects to a hosted payment page. Pick based on how you want to collect card data.


FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify credentials for the selected environment and account type (API Key + Secret Key for H2H/Merchant account, Service ID + Secret Key for Provider account)
  • 3DS redirect missing -> check that Send Term URL is enabled on the H2H Merchant account
  • Currency or service is not supported -> confirm allowed currencies/features in your account and in Corefy

Question

Still looking for help connecting your Global Financial Innovations account? Please contact our support team!