Kora¶

Simplified payments for your business

Set up Account¶

Step 1: Create merchant account¶

To create an account send connection request at the korahq.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:

Public key
Secret key
Encryption key

Connect H2H Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

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

Connect

Enter credentials:

Public key → Public key
Secret key → Secret key
Encryption key → Encryption key
Currency → choose currency (You can set these parameters according to available currencies and features for your Kora wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Success

You have connected Kora H2H merchant account!

API examples:¶

Maximum data set to create a transaction¶

POST /api/commerce/payment-invoices HTTP/1.1

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_ngn_hpp",
      "commerce_account": "Helo world",
      "currency": "NGN",
      "amount": 178,
      "flow": "charge",
      "gateway_options": {
        "cardgate": {
          "tokenize": ""
        }
      },
      "customer": {
        "reference_id": "c39d5464-975d-4865-9180-1d6d412ee593",
        "email": "[email protected]",
        "phone": "23414524688",
        "address": {
          "full_address": "Osapa, Lekki",
          "country": "NG",
          "region": "Lagos",
          "city": "Lekki",
          "post_code": "101010"
        }
      },
      "test_mode": false,
      "options": {
        "allow_partially": false,
        "bypass_hpp": false,
        "send_operation_context_on_return": false
      },
      "reference_id": "7570dd39-333a-4501-992f-2d25ca973295",
      "service_fields": []
    }
  }
}

Minimum data set to create a transaction¶

POST /api/commerce/payment-invoices HTTP/1.1

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_ngn_hpp",
      "commerce_account": "Hello world",
      "currency": "NGN",
      "amount": 189,
      "flow": "charge",
      "gateway_options": {
        "cardgate": {
          "tokenize": ""
        }
      },
      "customer": {
        "reference_id": "0733438d-3f5e-44e3-92e4-96baf679bf66",
        "email": "[email protected]"
      },
      "test_mode": false,
      "options": {
        "allow_partially": false,
        "bypass_hpp": false,
        "send_operation_context_on_return": false
      },
      "reference_id": "5c83dfdd-840f-4618-bca3-a098de20a3a0",
      "service_fields": []
    }
  }
}

Additional information¶

Provider Options¶

Provider_Options

ignore_callback
- for cascading to work correctly, we exclude the possibility of finalizing payments using asynchronous callbacks, ignore the callback, do not change the status of the transaction on it in any way and rely only on the status request for finalization (Reconciliation)

Still looking for help connecting your Kora account?

Please contact our support team!