Our Partner APIs are designed to enable business partners to securely integrate and interact with our platform services.
They provide programmatic access to key features such as authentication, virtual card management, fund loading, balance inquiry, and transaction monitoring.
These APIs are built to support scalable, secure, and real-time operations, allowing partners to seamlessly embed our financial services into their own systems and applications.
\nSecurity is a core principle of the platform. All API communications are protected through strong authentication mechanisms, encrypted data exchanges, and strict access controls. Sensitive information is handled in compliance with industry best practices and is only accessible through authorized and secured endpoints.
\nThe Partner APIs follow a RESTful architecture, use JSON as the data exchange format, and are accessible over HTTPS. Each partner is issued unique credentials and is responsible for securely managing their access keys and encryption materials.
\nThis documentation provides all the necessary details to help partners quickly onboard, integrate efficiently, and operate safely within our ecosystem.
\nAll the endpoint paths referenced in the API document are relative to a base URL below
\n\nYou can send an email to : support@keyzen.sn
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"29127020","collectionId":"2ec82078-63ca-4f54-a0b1-3af9bf723e3e","publishedId":"2sB3dWrmsu","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"61a12d"},"publishDate":"2025-12-24T14:48:46.000Z"},"item":[{"name":"Token","event":[{"listen":"test","script":{"id":"74d1f064-7b93-4925-82ee-e3b151236cb7","exec":["const auth = pm.response.json();\r","pm.test(\"Status Code\", function () {\r"," pm.environment.set(\"PARTNER_TOKEN\", auth.token); \r"," pm.response.to.have.status(200); \r"," console.log(auth.accessToken);\r","});"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"47109408-71d7-40e9-bbf1-5a264c07b59e","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"38174f33-c431-4cd5-b9ee-2836a6a2a3b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"login\": \"{{login}}\",\r\n \"password\": \"{{password}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/external/api/v1/auth/token","description":"This API allows the partner to authenticate using their login and password in order to
obtain a Bearer token.
The issued token is valid for 24 hours and must be included in the Authorization header
for all subsequent API requests.
This API allows the partner to activate a virtual card for a customer.
Once activated, the virtual card becomes usable for transactions according to the
defined usage rules and limits.
This API allows the partner to load funds onto a card.
The specified amount is credited to the card balance and becomes immediately
available for use, subject to validation and applicable limits.
This API allows the partner to debit funds from a card.
The specified amount is deducted from the card balance and credited to the partner’s account balance, subject to validation checks, available balance, and applicable limits.
This API allows the partner to retrieve the current available balance of a specific card.
\n","urlObject":{"path":["external","api","v1","card-balance","12746809"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"121ba210-45b6-4b7a-b55b-60520e2cbb80","name":"Successful Response","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/external/api/v1/card-balance/12746809"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx/1.29.0"},{"key":"Date","value":"Mon, 22 Dec 2025 00:09:48 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Keyzen-Request-ID","value":"69488c4c874554e3bf439ea72cdf0ad4"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"vary","value":"accept-encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Backend-Server","value":"192.168.4.9:9090"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": \"SUCCESS\",\n \"codeRetour\": 0,\n \"response\": {\n \"balance\": 1000,\n \"currencyCode\": \"XOF\"\n }\n}"}],"_postman_id":"2eac6f7a-cf12-4ee4-94bb-0e712ddfabb5"},{"name":"Change Card Status","event":[{"listen":"test","script":{"id":"74d1f064-7b93-4925-82ee-e3b151236cb7","exec":["const auth = pm.response.json();\r"," pm.test(\"Status Code\", function () {\r"," pm.response.to.have.status(200); \r","});"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"47109408-71d7-40e9-bbf1-5a264c07b59e","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"29f21f0b-f0ce-4770-a125-290dccb829a0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{PARTNER_TOKEN}}"}],"advancedConfig":[{"key":"password","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cid\": \"12746809\",\r\n \"action\": \"Unblocking\", // Blocking | Unblocking\r\n \"type\": \"Temporary\" // Temporary | Definitive\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/external/api/v1/change-card-status","description":"This API allows the partner to change the status of a card (e.g. active, inactive, preactive,
deactivated).
This operation is typically used for security or operational purposes.
This API allows the partner to retrieve sensitive card information such as the PAN, CVV
and Expiration Date.
Access to this API is strictly controlled and secured, and should only be used for
authorized and compliant use cases.
The partner must generate a 2048-bit RSA key pair in compliance with industry security standards.
The public key shall be securely transmitted to Keyzen and will be used exclusively for encrypting sensitive data.
The private key must remain strictly confidential, securely stored on the partner’s infrastructure, and must never be shared. It is solely used by the partner for decryption purposes.
The tool referenced below may be used for RSA key pair generation, provided it meets the partner’s internal security and compliance requirements.
\nLien: https://www.devglan.com/online-tools/rsa-encryption-decryption
\n","urlObject":{"path":["external","api","v1","card","ff9ed25ccfd9131ac4953ea74744b59876a5609a","infos"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"86d4df66-ba0f-4828-806e-f9c86cf2d497","name":"Successful Response","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/external/api/v1/card/ff9ed25ccfd9131ac4953ea74744b59876a5609a/infos"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx/1.29.0"},{"key":"Date","value":"Mon, 22 Dec 2025 14:35:51 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Keyzen-Request-ID","value":"694957457c36bfbeb9a52ee8acd0251b"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"vary","value":"accept-encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"X-Backend-Server","value":"192.168.4.16:9090"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": \"SUCCESS\",\n \"codeRetour\": 0,\n \"infos\": {\n \"pan\": \"A1gIJRtUfNNlCBdFm4IiQB+nE4lHv8owMb8IQjaWTFyIL4LDhKmN0cB37AdZw91n/jxSVKXplwqgBdewABsvObDdecEIA7lqhTLpYR0QwCRqcGwXm5WGErl/aT1kAqDH4LJENu3InRxcH0e2sQ4q/J3j1/ietOxhPAIvAjqWzCJnj43bih7m01IBwZG4qgnkZgiGrVjserJ9go5ATw4uTx18p0Oz7IA5ej9mOzkyXIhRPgt+0lWRt7aLvwiML3jvqDoq7SP4KmwxuCuFbp6qf/14Nwh2ctWFZFEQchDgEQ0qREWxf1sf6yJhvP129urE3d0+GCJmKaoJs2nBhcwK3Q==\",\n \"cvv\": \"fvLOKDTml0WxyRAVaQm4ImxOV16mXY+Esemwtif+1OEA9DN3XpVg+4vf1wdGrA6foyrF2phNROlvnso3ytxGTs9z+0tkEepQN8zzBKa6RQGSQPj+cfS0kdrfBG3jRCo4K/2hskX8YQZ9YRL+XV5A9j3iA+kQ2uT2atT4BIGvak/kplZhr9EX1T4ilP0gx032FckYa45VeM6OdAQrWAyWsdma5RI0KpczYFHF2rzzmFITYyyjhD3ysVxhvcmQzYOYenWn6qWp2u7UB1/V32NhTl1H/6TrrWhaH4s81gQ6QoLcfQs8yLWH7AdxZ5GfgGwxEURG077MrcTrUiS9kQ8Eag==\",\n \"expireDateCardFormat\": \"12/28\"\n }\n}"},{"id":"7485bd6e-64be-4a8b-896b-d2b360c62222","name":"Failure Response","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/external/api/v1/card/ff9ed25ccfd9131ac4953ea74744b59876a5609a/infos"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Server","value":"nginx/1.29.0"},{"key":"Date","value":"Sun, 21 Dec 2025 23:52:41 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Keyzen-Request-ID","value":"69488848f70bba534e37dea88aff2d38"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"vary","value":"accept-encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Referrer-Policy","value":"no-referrer"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": \"FAILURE\",\n \"codeRetour\": 1,\n \"messageRetour\": \"Impossible de récupérer les infos de la carte.\"\n}"}],"_postman_id":"694f42d9-a534-4767-9c83-e76e3622a201"},{"name":"Card Transaction","event":[{"listen":"test","script":{"id":"74d1f064-7b93-4925-82ee-e3b151236cb7","exec":["const auth = pm.response.json();\r"," pm.test(\"Status Code\", function () {\r"," pm.response.to.have.status(200); \r","});"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"47109408-71d7-40e9-bbf1-5a264c07b59e","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"366e6569-ec56-4c85-acb2-b4c06ddafc67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{PARTNER_TOKEN}}"}],"advancedConfig":[{"key":"password","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/external/api/v1/card-transaction/12746809?beginDate=2025-12-20&endDate=2025-12-22","description":"This API allows the partner to retrieve the list of transactions associated with a specific
card, including details such as amount, date, reference, transaction type...
This API allows the partner to retrieve their current account balance, reflecting the
available funds for card operations.