Skip to content

Logo

Converge Gate

Supports in this guide: Payments

Provider website: convergegate.com

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

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

Choose account type

Converge Gate can be connected in different ways (depending on your needs):

  • If you do direct card payments (H2H, no redirect) -> choose H2H Merchant account
  • If you do BLIK (Poland, redirect) -> choose Provider account

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

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Api user -> api_user
  • Api key -> api_key
  • Api password -> api_password
  • Currency / Features -> choose values available for your account (EUR, USD, GBP)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Converge Gate 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. 3D Secure is always used - there is no non-3DS mode for this connector.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6be05631-8710-4b14-a369-1928a2b70eda",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123"
      }
    }
  }
}

Important

customer must be present on every request (even with just reference_id) - Converge Gate's own request-building code reads a field directly off the customer object with no null-safety, so a request with no customer block at all fails rather than being treated as "no customer data".

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "199be985-c243-478a-86a8-4b8c902e5bb6",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "test@test.com",
        "phone": "+380680786663",
        "date_of_birth": "1990-01-01",
        "address": {
          "full_address": "Main street 1",
          "country": "GB",
          "city": "London",
          "post_code": "W1J 5AX"
        },
        "metadata": {
          "ip": "203.0.113.42"
        }
      }
    }
  }
}

Important

customer.name is split into first/last name and used both as the billing name and the card's cardholder-name fallback; any field you don't send (email, phone, date of birth, address, metadata.ip) is simply left out of the request to Converge Gate - there are no Constants 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

Refunds

Converge Gate supports partial refunds, but only one refund per payment (no multiple partial refunds against the same payment). The original transaction ID is required to process a refund.

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant ID -> merchant_id
  • API URL -> api_url -> use the test URL here (not the production URL) if you want Test Mode transactions - enabling Test Mode alone does not switch the endpoint
  • API key -> api_key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Converge Gate Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to Converge Gate's hosted BLIK payment page.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "c0252411-b06d-4994-bfec-05e2791b9654",
      "service": "blik_pln_hpp",
      "currency": "PLN",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "test@test.com",
        "address": {
          "country": "PL"
        }
      }
    }
  }
}

Important

  • customer.email, customer.name (split into first/last name) and customer.address.country are all required - Corefy rejects the request if customer.email/.name is missing, matching the provider's own validation.
  • If customer is present but customer.address is missing entirely, the request fails locally with an error rather than Converge Gate simply receiving an empty country - send customer.address.country whenever you send a customer object on this flow.

Extended request (MAX)

This flow has no optional extension beyond what's shown above - no other customer fields are read by Converge Gate for BLIK.

Refunds

Converge Gate does not support refunds on the Provider account flow.

Additional info

  1. Active reconciliation is available on both flows - the asynchronous callback and an active status request can both finalize the payment.
  2. No recurring - this connector does not support saving/charging a token through Corefy.
  3. No Options or Constants are configured for this connector.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify your credentials for the selected environment and account type
  • Currency or service is not supported -> confirm allowed currencies/features in your Converge Gate account and in Corefy - H2H Merchant account supports EUR/USD/GBP, Provider account supports PLN (BLIK) only
  • Payment fails with no customer data sent -> always send at least customer.reference_id; for Provider account (BLIK), also send customer.email, customer.name and customer.address.country
  • Refund fails with multiple attempts -> only one refund per payment is allowed, and only on the H2H Merchant account flow
  • Not sure which account type to use? -> ask your Corefy account manager

Question

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