E-Wallet

E-wallet Call Flow

With the Wallet payment type, partners will receive a redirect link for the customer to complete their payment. Usually, it’s either the deep link (directly opening the wallet app) or the redirection page where the customer needs to fill in some additional information and authorize the payment.

Request Message

Item Info

Item represents a SKU Code and Name should be unique and univocally represent the item. The name needs to be user-friendly, as it shows to end-users in the payment window.

Other Details In Profile Field

Sample of Request

Require msisdn and email

{
    "api_key":"<YOUR API KEY>",
    "order_id":"<Your Order ID>",
    "lang":"en",
    "merchant_name":"Koko eBooks",
    "pay_type":"5",
    "pay_channel":"20",
    "type":"1",
    "msisdn":"<phone number>",
    "email":"<email address>" ,
    "items":[{
        "code":"456789",
        "name":"One Day",
        "price":1000.00
    }],
    "profile":{"user_id":"12345"}
}

Require customer name and id_no

{
    "api_key": "<YOUR API KEY>",
    "order_id": "<Your Order ID>",
    "lang": "en",
    "merchant_name": "Koko eBooks",
    "type": "1",
    "pay_type": "5",
    "pay_channel": "98",
    "email": "[e-mail]",
    "msisdn": "123432",
    "items": [
        {
            "code": "1",
            "name": "One Day",
            "price": 3
        }
    ],
    "profile":{"name":"CodaUser","user_id":"12345","id_no":"88899988811"}
}

Msisdn and email not required

{
    "api_key":"<YOUR API KEY>",
    "order_id":"<Your Order ID>",
    "lang":"en",
    "merchant_name":"Koko eBooks",
    "pay_type":"5",
    "pay_channel":"39",
    "type":"1",
    "items":[{
        "code":"456789",
        "name":"One Day",
        "price":1000.00
    }],
    "profile":{"user_id":"12345"}
}

Require Document number and type

{
  "api_key": "<YOUR API KEY>",
  "order_id": "<Your Order ID>",
  "lang": "en",
  "pay_type": "5",
  "pay_channel": "255",
  "email": "[e-mail]",
  "type": "1",
  "merchant_name": "Koko eBooks",
  "items": [
    {
      "code": "1",
      "name": "ebook",
      "price": "1000.0",
      "type": "0",
    }
  ],
  "profile": {
    "document_number": "1134568011",
    "user_id": "12345",
    "document_type": "CC"
  }
}

Response Message

Other Details In Profile Field

Sample Of Response

Require msisdn and email

{
   "txn_id": <coda transaction ID>,
   "txn_timeout": 20,
   "result_code": 431,
   "result_desc": "Please wait a few minutes for your transaction to be completed. Need Help? Visit our <a href=“http://bit.ly/idCODAhelp” target=“_blank”>Help Center</a>.",
   "total_price": 1000.0,
   "pay_instructions": "",
   "profile": {
        "extInfoByte": "11",
        "user_id": "12345",
        "merchantType": "Codapay",
        "payment_code": ""
    }
}

Require customer name and id_no

{
    "txn_id": <coda transaction ID>,
    "txn_timeout": 1445,
    "result_code": 431,
    "result_desc": null,
    "total_price": 3.03,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "id_no": "88899988811",
        "user_id":"12345",
        "redirect_url": "https://sample_URL.com",
        "payment_code": ""
    }
}

Msisdn and email not required

{
    "txn_id": <coda transaction ID>,
    "txn_timeout": 11,
    "result_code": 0,
    "result_desc": null,
    "total_price": 1000.0,
    "pay_instructions": "",
    "profile": {
        "redirect_url": "https://sample_URL.com",
        "extInfoByte": "0",
        "payment_code": ""
    }
}

Require Document number and type

{
    "txn_id": <coda transaction ID>,
    "txn_timeout": 17,
    "result_code": 431,
    "total_price": 1000.0,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "document_number": "1134568011",
        "user_id": "12345",
        "merchantType": "Codapay",
        "redirect_url": "https://sample_URL.com",
        "document_type": "CC",
        "payment_code": ""
    }
}

Reference of USD Transactions

Please check out this guide to learn more about USD transactions.