Klasha¶

Global trade, local payments. We make it easy for businesses to transact in emerging markets as seamlessly as experienced on other continents through niche payment solutions and APIs.

Website: klasha.com

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the klasha.com/contact 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:

klasha__username
klasha__password
klasha__public_key
klasha__secret_key
klasha__encryption_key
klasha__test_mode
klasha__currency → choose currency (You can set these parameters according to available currencies and features for your Klasha wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Connect Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

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

Connect

Enter credentials:

Username
Password
Public Key
Private Key
Encryption Key
Test Mode = true/mode

Success

You have connected Klasha H2H merchant account!

Set up Account Provider account¶

Step 1: Create Provider account¶

To create an account send connection request at the klasha.com/contact 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:

klasha__username → Username
lasha__password → Password
klasha__public_key → Public Key
klasha__secret_key → Private Key
klasha__encryption_key → Encryption key

Connect Provider Account¶

Step 1. Connect Provider account at the Corefy Dashboard¶

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

Connect

Enter credentials:

Username
Password
Public Key
Private Key
Encryption key

Success

You have connected Klasha Provider account!

API examples:¶

Minimum data set to create a payout invoices for access_bank_nigeria_ngn service¶

PAYOUT

POST /api/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "reference_id":"1713255426",
      "description":"string",
      "test_mode":true,
      "currency":"NGN",
      "service_amount":10,
      "service":"access_bank_nigeria_ngn",
      "fields":{
        "account_number":"1222951828",
        "beneficiary_first_name":"Pastor",
        "beneficiary_last_name":"Bright"
      },
      "options":{
        "attempts_limit":0,
        "split_mode":false,
        "allow_partially":false,
        "auto_process":false
      }
    }
  }
}
}

Maximum data set to create a payout invoices for access_bank_nigeria_ngn service¶

PAYOUT

POST /api/commerce/payout-invoices HTTP/1.0
{
  "data":{
    "type":"payout-invoice",
    "attributes":{
      "service":"access_bank_nigeria_ngn",
      "commerce_account":"coma_CZE6TBkJ1R2WYXtQ",
      "currency":"NGN",
      "amount":100.01,
      "customer":{
        "reference_id":"87db88c9-4cf5-4d22-b5b2-9b3335fa58b2",
        "address":{
          "country":"NG"
        }
      },
      "test_mode":true,
      "reference_id":"a330a550-517f-4a24-9abd-f0245c529e49",
      "fields":{
        "account_number":"1222951828",
        "beneficiary_first_name":"John",
        "beneficiary_last_name":"Doe"
      },
      "options":{
        "attempts_limit":0,
        "split_mode":false,
        "allow_partially":false,
        "auto_process":false
      }
    }
  }
}

Minimum data set to create a payment invoices for bank_transfer_zar_hpp service¶

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "bank_transfer_zar_hpp",
      "commerce_account": "hello_world",
      "currency": "ZAR",
      "amount": 101,
      "expires": "2023-06-29T13:59:47Z",
      "flow": "charge",
      "test_mode": false,
      "reference_id": "1a8d86af-7eaa-4e26-b564-27f83569d718",
      "service_fields": {
        "payer_email": "[email protected]",
        "payer_phone_number": "+054709929220",
        "payer_full_name": "Test"
      }
    }
  }
}

Maximum data set to create a payment invoices for bank_transfer_zar_hpp service¶

PAYMENT

POST /api/commerce/payment-invoices HTTP/1.1
{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "bank_transfer_zar_hpp",
      "commerce_account": "hello_world",
      "currency": "ZAR",
      "amount": 101,
      "expires": "2023-06-29T13:59:47Z",
      "flow": "charge",
      "gateway_options": {
        "cardgate": {
          "tokenize": ""
        }
      },
      "test_mode": false,
      "reference_id": "1a8d86af-7eaa-4e26-b564-27f83569d718",
      "service_fields": {
        "payer_email": "[email protected]",
        "payer_phone_number": "+054709929220",
        "payer_full_name": "Test"
      }
    }
  }
}

Сonstants

If some parameters are not sent in the transaction creation request, they will take the values from the set constants.

Here is a list of constants with their corresponding parameters:

COUNTRY → customer [address] [country]

Provider Options¶

Provider_Options

validate_account_number
- Validate recipient account number

Question

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