Skip to content

Logo

Convergegate

Synthesizing Connections. Integrating Technology and Payments to Perfect Harmony

Website: convergegate.com

Set up Account H2H merchant account

Step 1: Create Merchant Account

To create an account send connection request at the convergegate.com/#contact-us or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

  • convergegate__api_user → Api user
  • convergegate__api_password → Api password
  • convergegate__api_key → Api key
  • convergegate__currency → Currency
  • convergegate__test_mode → Test mode

Connect Merchant Account

Step 1. Connect H2H account at the Corefy Dashboard

Press Connect at Convergegate Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Connect

Enter credentials:

  • Api user
  • Api password
  • Api Key
  • Currency
  • Test mode → true/false

Success

You have connected Convergegate H2H merchant account!

Set up Account Provider account

Step 1: Create Provider account

To create an account send connection request at the convergegate.com/#contact-us or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials

Credentials that have to be issued:

  • convergegate__merchant_id → Merchant id
  • convergegate__api_url → Api url
  • convergegate__api_key → Api key
  • convergegate__test_mode → Test mode

Connect Provider Account

Step 1. Connect Provider account at the Corefy Dashboard

Press Connect at Convergegate Provider Overview page in 'New connection' section and choose Provider account option to open Connection form.

Connect

Enter credentials:

  • Merchant id
  • Api url
  • Api key
  • Test mode → true/false * to run transactions in test mode, enter the test URL in the API URL field. If you enter the production URL but enable test mode, the transactions will run in production mode.

Success

You have connected Convergegate Provider account!

API examples:

Minimum data set to create a payment invoices for blik_pln_hpp service

PAYMENT
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"blik_pln_hpp",
      "commerce_account":"hello_world",
      "currency":"PLN",
      "amount":5,
      "reference_id":"c0252411-b06d-4994-bfec-05e2791b9654",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"pln",
        "name":"Jhon Wick",
        "email":"[email protected]"
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

Maximum data set to create a payment invoices for blik_pln_hpp service

PAYMENT
POST /api/commerce/payment-invoices HTTP/1.0
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"blik_pln_hpp",
      "commerce_account":"hello_world",
      "currency":"PLN",
      "amount":5,
      "reference_id":"742d8d47-5818-407a-8ad2-37d2ec1fb925",
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"1686072f-a0cd-48fe-a603-3cc36984e353",
        "name":"Jhon Wick",
        "email":"[email protected]",
        "address":{
          "country":"PL"
        }
      },
      "test_mode":false,
      "options":{
        "allow_partially":false,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "service_fields":[
      ]
    }
  }
}

API examples CardGate:

Minimum data set to create a payment invoices for payment_card_usd_hpp service

POST /api/payment-invoices HTTP/1.0
{
  "data": {
    "type": "payment-invoices",
    "test_mode": true,
    "reference_id": "pay_r3aIW2nFxdDg1E3fRA6nWr0K",
    "attributes": {
      "amount": 1,
      "currency": "USD",
      "service": "payment_card_eur_hpp",
      "customer": {
        "reference_id": "1234",
        "name": "Test Full Name",
        "email": "[email protected]",
        "phone": "1111111111",
        "date_of_birth": "1999-01-01",
        "first_name": "Test Name",
        "surname": "Test Surname",
        "address": {
          "country": "BE",
          "region": "TEST",
          "city": "TEST",
          "street": "TEST",
          "full_address": "TEST",
          "post_code": "12345"
        },
        "metadata": {
          "ip": "0.0.0.0"
        }
      }
    }
  }
}

Maximum data set to create a payment invoices for payment_card_eur_hpp service

POST /api/payment-invoices HTTP/1.0
{
  "data": {
    "type": "payment-invoices",
    "test_mode": true,
    "reference_id": "pay_r3aIW2nFxdDg1E3fRA6nWr0K",
    "attributes": {
      "amount": 1,
      "currency": "USD",
      "service": "payment_card_eur_hpp",
      "customer": {
        "reference_id": "1234",
        "name": "Test Full Name",
        "email": "[email protected]",
        "phone": "1111111111",
        "date_of_birth": "1999-01-01",
        "first_name": "Test Name",
        "surname": "Test Surname",
        "address": {
          "country": "BE",
          "region": "TEST",
          "city": "TEST",
          "street": "TEST",
          "full_address": "TEST",
          "post_code": "12345"
        },
        "metadata": {
          "ip": "0.0.0.0"
        }
      }
    }
  }
}

Question

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