API ReferenceDeveloper ConsoleDeveloper Community

Generate Token

This page will help you get started with New Value Added Services.

This is the call to do an SVA transaction (Recharge / BillPayment/ Transfer)

Request Message description

Field #Field NameData typeMax LengthRequiredDescription
1grantTypestringyesThis is the type of grant available to the customer
2scopestringyesThe is the scope available to the customer

📘

End Point

POST https://passport.k8.isw.la/passport/oauth/token

📘

Headers

Authorization: Basic aXN3LXBvcnRhbDpzZWNyZXQ=
Content-type: x-www-form-urlencoded

The "aXN3LXBvcnRhbDpzZWNyZXQ=" value is the base64encoded value of the customer's clientId and clientSecret.

Sample: base64encode of below:

IKIA72C65D005F93F30E573EFEAC04FA6DD9E4D344B1:YZMqZezsltpSPNb4+49PGeP7lYkzKn1a5SaVSyzKOiI=

Sample Request Body

📘

x-www-form-urlencoded

grant_type : client_credentials
scope : profile

Sample Response (success) 

{
    "access_token": "eyJhbGciOiJSUzI1NiJ9.eyJtZXRhZGF0YSI6eyJpbnN0aXR1dGlvbkNvZGUiOiJRVFMifSwibWVyY2hhbnRfY29kZSI6IlFURUxMIiwicmVxdWVzdG9yX2lkIjoiMDAxMTA5MTk1NTEiLCJ0ZXJtaW5hbElkIjoiM1BCTCIsInBheWFibGVfaWQiOiIxMDMiLCJjbGllbnRfZGVzY3JpcHRpb24iOm51bGwsImNsaWVudF9pZCI6IklLSUE3MkM2NUQwMDVGOTNGMzBFNTczRUZFQUMwNEZBNkREOUU0RDM0NEIxIiwiYXVkIjpbImFwaS1nYXRld2F5IiwiYXJiaXRlciIsImNhZXNhciIsImhpbXMtcG9ydGxldCIsImlzdy1jb2xsZWN0aW9ucyIsImlzdy1jb3JlIiwiaXN3LWluc3RpdHV0aW9uIiwiaXN3LWxlbmRpbmctc2VydmljZSIsImlzdy1wYXltZW50Z2F0ZXdheSIsImlzdy1wb3N0LW9mZmljZSIsImt5Yy1zZXJ2aWNlIiwicGFzc3BvcnQiLCJwcm9qZWN0LXgtY29uc3VtZXIiLCJwcm9qZWN0LXgtbWVyY2hhbnQiLCJxdC1zZXJ2aWNlIiwicXVpY2t0ZWxsZXItZXRsci1yZXF1ZXJ5IiwicmVjdXJyZW50LWJpbGxpbmctYXBpIiwic2NwbGl0ZS1zZXJ2aWNlIiwidHJhbnNmZXItc2VydmljZS1hZG1pbiIsInRyYW5zZmVyLXNlcnZpY2UtY29yZSIsInZvdWNoZXItYXBpIiwid2FsbGV0Iiwid2VicGF5LXBvcnRsZXQiXSwic2NvcGUiOlsiY2xpZW50cyIsInByb2ZpbGUiXSwiYXBpX3Jlc291cmNlcyI6WyJyaWQtR0VUL2Nvbm5lY3QvY3VzdG9tZXJyZWZlcnJhbC8qKiIsInJpZC1QT1NUL2Nvbm5lY3QvY3VzdG9tZXJyZWZlcnJhbC8qKiIsInJpZC1HRVQvY29ubmVjdC9jdXN0b21lcnMvKioiLCJyaWQtUE9TVC9jb25uZWN0L2N1c3RvbWVycy8qKiIsInJpZC1QT1NUL2FwaS92MS9jYW1wYWlnbnMvKioiLCJyaWQtR0VUL2FwaS92MS9jdXN0b21lci1iYW5rLWFjY291bnRzLyoqIiwicmlkLVBPU1QvYXBpL3YxL2N1c3RvbWVyLWJhbmstYWNjb3VudHMvKioqIiwicmlkLUdFVC9hcGkvdjEvZGFzaGJvYXJkLyoqIiwicmlkLUdFVC9hcGkvdjEvZml4ZWQtdmFsdWVzLyoqIiwicmlkLUdFVC9hcGkvdjEvc2F2aW5ncy1wbGFucy8qKiIsInJpZC1QT1NUL2FwaS92MS9wYXltZW50LXRyYW5zYWN0aW9ucy8qKiIsInJpZC1HRVQvYXBpL3YxL2N1c3RvbWVyLXRyYW5zYWN0aW9ucy8qKiIsInJpZC1QT1NUL2FwaS92MS9maXhlZC1kZXBvc2l0cy8qKiIsInJpZC1HRVQvYXBpL3YxL2ZpeGVkLWRlcG9zaXRzLyoqIiwicmlkLUdFVC9hcGkvdjEvcHJvdmlkZXItZGV0YWlscy8iLCJyaWQtUE9TVC9hcGkvdjEvcHJvdmlkZXItZGV0YWlscy8iLCJyaWQtUE9TVC9hcGkvdjEvaWZpcy8qKiIsInJpZC1HRVQvYXBpL3YxL2lmaXMvKioiLCJyaWQtUE9TVC9pZmlzLXNlcnZpY2UvKioiLCJyaWQtR0VUL2lmaXMtc2VydmljZS8qKiIsInJpZC1QT1NUL3F1aWNrdGVsbGVyLXdlYWx0aGh1Yi9hcGkvdjEvKioiLCJyaWQtR0VUL3F1aWNrdGVsbGVyLXdlYWx0aGh1Yi9hcGkvdjEvKioiLCJyaWQtUE9TVC9xdWlja3RlbGxlcnNlcnZpY2UvYXBpL3YzLyoqIiwicmlkLUdFVC9xdWlja3RlbGxlcnNlcnZpY2UvYXBpL3YzLyoqIiwicmlkLVBPU1QvcG9zdG9mZmljZSIsInJpZC1QT1NUL3Bvc3RvZmZpY2UvIl0sImV4cCI6MTY0MzAxMTQxMCwiY2xpZW50X25hbWUiOiJxdWlja3RlbGxlci13ZWJzaXRlLVVhdCIsImNsaWVudF9sb2dvIjpudWxsLCJqdGkiOiIzYTE4MzljZS1jYzAyLTQyNzgtOTY5Zi0zZTQ0YTIzYzljNjQiLCJwYXltZW50X2NvZGUiOiIwNTE0NTU5MTI1NTUwIiwiY2xpZW50X2NvZGUiOiJQQkwifQ.c71XSN2hfIe_ZfCcviJZ5cd1dsU8sRA3Cr0cdvO4lXnTREnTdOXUSls0EH5QxiwFmW-K37UtBu3KngFPSzsbvNn9lBqslk2fsC2dN59rYlhL5LVpdbBjV2toeVA6N3Knj4GSWO52XndYf-WI7DI02M3hgsFDD4eseJsKaoR1BcwXfKgkoH4eVIHnxdST0ufaGB9QjuxAEGJAJvWcJectsHptb4xJTdaB1p_vrpvPjsOhk7cjk3ztocujpHehuZ-CQHzCbaZTNvPtzy1ug4S5vP1a8sljyskXlgyzUP0l5DkrtO05047_rAXwUvDvJ0DWNUq43gYpvBl973RlqooNbQ",
    "token_type": "bearer",
    "expires_in": 16070399,
    "scope": "clients profile",
    "metadata": {
        "institutionCode": "QTS"
    },
    "merchant_code": "QTELL",
    "requestor_id": "00110919551",
    "api_resources": [
        "rid-GET/connect/customerreferral/**",
        "rid-POST/connect/customerreferral/**",
        "rid-GET/connect/customers/**",
        "rid-POST/connect/customers/**",
        "rid-POST/api/v1/campaigns/**",
        "rid-GET/api/v1/customer-bank-accounts/**",
        "rid-POST/api/v1/customer-bank-accounts/***",
        "rid-GET/api/v1/dashboard/**",
        "rid-GET/api/v1/fixed-values/**",
        "rid-GET/api/v1/savings-plans/**",
        "rid-POST/api/v1/payment-transactions/**",
        "rid-GET/api/v1/customer-transactions/**",
        "rid-POST/api/v1/fixed-deposits/**",
        "rid-GET/api/v1/fixed-deposits/**",
        "rid-GET/api/v1/provider-details/",
        "rid-POST/api/v1/provider-details/",
        "rid-POST/api/v1/ifis/**",
        "rid-GET/api/v1/ifis/**",
        "rid-POST/ifis-service/**",
        "rid-GET/ifis-service/**",
        "rid-POST/quickteller-wealthhub/api/v1/**",
        "rid-GET/quickteller-wealthhub/api/v1/**",
        "rid-POST/quicktellerservice/api/v3/**",
        "rid-GET/quicktellerservice/api/v3/**",
        "rid-POST/postoffice",
        "rid-POST/postoffice/"
    ],
    "terminalId": "3PBL",
    "client_name": "quickteller-website-Uat",
    "client_logo": null,
    "payable_id": "103",
    "client_description": null,
    "payment_code": "0514559125550",
    "client_code": "PBL",
    "jti": "3a1839ce-cc02-4278-969f-3e44a23c9c64"
}