Skip to content

Logo

Gate2way

Payments done right. With the right network of payment providers, we facilitate a direct connection to the most popular processing products for your business.

Supports in this guide: Payments

Provider website: gate2way.com

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

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

Prerequisites: get from Gate2way

Send a connection request at gate2way.com/contact or contact your Gate2way account manager directly to get your account verified and receive the following credentials.

  • Website ID -> Corefy field website_id.
  • API key -> Corefy field api_key.
  • API secret -> Corefy field api_secret.

EUR only.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Website ID
  • API key
  • API secret
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Gate2way 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": "ea76ffb1-17ad-4fd8-bb1b-1362ab791ed9",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8f1b6a26-df30-4410-83a0-8572bf055b03",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "+1111111111",
        "date_of_birth": "1995-01-02",
        "address": {
          "full_address": "Main street 1",
          "country": "GB",
          "city": "London",
          "post_code": "W1J 5AX"
        }
      }
    }
  }
}

Important

If customer.name, customer.email, customer.phone, customer.reference_id, or customer.date_of_birth is missing, Corefy falls back to the matching Constant; if the Constant isn't set either, a fixed placeholder value (a fake name, email, phone, reference, and date of birth) is sent to Gate2way instead of leaving the field empty. Address fields (street, city, country, postcode) have no such fallback - they're simply omitted if missing.

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

  • payment_method -> optional, enum - forces a specific card network/processing variant (combinations of Visa/Mastercard with Gate2way's own routing flavors) instead of letting Gate2way auto-detect it from the card's network.

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 -> a fixed placeholder value is sent instead (see note above)

Currently available constants (constant -> Corefy API field)

  • EMAIL -> customer.email
  • FIRST_NAME -> customer.name (first part)
  • LAST_NAME -> customer.name (second part)
  • PHONE -> customer.phone
  • REFERENCE_ID -> customer.reference_id
  • DATE_OF_BIRTH -> customer.date_of_birth

Refunds

Gate2way does not support refunds.

Additional info

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

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Website ID, API key and API secret for the selected environment (test_mode)
  • Unexpected placeholder data received by Gate2way -> this is expected when both customer fields and the matching Constants are missing - set at least the Constants to avoid sending placeholder data
  • Currency or service is not supported -> confirm allowed currencies/features in your Gate2way account and in Corefy - only EUR is available
  • Refund fails -> Gate2way does not support refunds through Corefy

Question

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