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)
- Choose account type
- Get your credentials (from Global Financial Innovations)
- Connect in Dashboard
- 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, orRU.
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
-
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. -
"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!