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 Name | Data type | Max Length | Required | Description |
|---|---|---|---|---|---|
| 1 | grantType | string | yes | This is the type of grant available to the customer | |
| 2 | scope | string | yes | The is the scope available to the customer |
End Point
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"
}