By Fawaz ADISA fawaz@adisa.ci
\nFrançais : Cette collection s'adresse à tous les marchands CinetPay qui veulent effectuer des transferts d'argent sur des comptes mobiles money via des processus automatiques (Site internet, App mobiles etc…).\nAvant de procéder à l'intégration de l'api de transfert d'argent, veuillez-vous assurer d'avoir un compte marchand CinetPay (https://cinetpay.com/) et avoir configurer le mot de passe d'API (https://cinetpay.com/marchand/integration/).
\nVous devez configurer un lien de notification, il est celui qui est appelé par la plateforme pour vous notifier de l'état de votre transfert d'argent. \nCette URL doit être disponible pour accueillir des requêtes HTTP de type GET et POST.
Le serveur exécute une requête de type POST contenant :
English : This collection is intended for all CinetPay merchants who want to transfer money to mobile money accounts through automatic processes (Websites, Mobile Apps, …).\nBefore proceeding with the integration of the money transfer API, please ensure that you have:
\nYou must configure the notify URL, it is a link that called by CinetPay after a transfer process. This URL must be available for HTTP GET and POST requests.\nThe server executes a HTTP POST type query containing:
\nFrench : Pour consommer les endpoints de l'API, il vous faut générer un token; ceci permet de generer un token\nEnglish : To use the API, you must generate a token
\n","urlObject":{"protocol":"https","path":["v1","auth","login"],"host":["client","cinetpay","com"],"query":[{"key":"lang","value":"fr"}],"variable":[]}},"response":[{"id":"5fef7724-10d1-4001-ae15-3a813205d994","name":"Exemple resultat : Echec","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","disabled":false}],"body":{"mode":"urlencoded","urlencoded":[{"key":"apikey","value":"your_apikey_here","type":"text"},{"key":"password","value":"your_password_here","type":"text"}]},"url":"https://client.cinetpay.com/v1/auth/login "},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Auth-Token, Origin, Authorization","name":"Access-Control-Allow-Headers","description":"Used in response to a preflight request to indicate which HTTP headers can be used when making the actual request."},{"key":"Access-Control-Allow-Methods","value":"GET,POST","name":"Access-Control-Allow-Methods","description":"Specifies the method or methods allowed when accessing the resource. This is used in response to a preflight request."},{"key":"Access-Control-Allow-Origin","value":"*","name":"Access-Control-Allow-Origin","description":"Specifies a URI that may access the resource. For requests without credentials, the server may specify '*' as a wildcard, thereby allowing any origin to access the resource."},{"key":"Access-Control-Expose-Headers","value":"api.client.transfert","name":"Access-Control-Expose-Headers","description":"Lets a server whitelist headers that browsers are allowed to access."},{"key":"CF-RAY","value":"43079313af233d95-MXP","name":"CF-RAY","description":"Custom header"},{"key":"Cache-Control","value":"private, must-revalidate","name":"Cache-Control","description":"Tells all caching mechanisms from server to client whether they may cache this object. It is measured in seconds"},{"key":"Connection","value":"keep-alive","name":"Connection","description":"Options that are desired for the connection"},{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"The mime type of this content"},{"key":"Date","value":"Mon, 25 Jun 2018 12:53:00 GMT","name":"Date","description":"The date and time that the message was sent"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"","name":"Expect-CT","description":"Custom header"},{"key":"Server","value":"cloudflare","name":"Server","description":"A name for the server"},{"key":"Transfer-Encoding","value":"chunked","name":"Transfer-Encoding","description":"The form of encoding used to safely transfer the entity to the user. Currently defined methods are: chunked, compress, deflate, gzip, identity."},{"key":"X-Powered-By","value":"Tomcat 7.0.77","name":"X-Powered-By","description":"Specifies the technology (ASP.NET, PHP, JBoss, e.g.) supporting the web application (version details are often in X-Runtime, X-Version, or X-AspNet-Version)"},{"key":"X-RateLimit-Limit","value":"60","name":"X-RateLimit-Limit","description":"Custom header"},{"key":"X-RateLimit-Remaining","value":"59","name":"X-RateLimit-Remaining","description":"Custom header"},{"key":"expires","value":"-1","name":"expires","description":"Gives the date/time after which the response is considered stale"},{"key":"pragma","value":"no-cache","name":"pragma","description":"Implementation-specific headers that may have various effects anywhere along the request-response chain."}],"cookie":[{"expires":"Tue Jan 22 2019 11:28:44 GMT+0000 (Coordinated Universal Time)","httpOnly":true,"domain":"cinetpay.com","path":"/","secure":false,"value":"d971d0b5c105040d409c62283da4ed9251516620524","key":"__cfduid"},{"expires":"Tue Jun 26 2018 11:18:57 GMT+0000 (Coordinated Universal Time)","httpOnly":false,"domain":"client.cinetpay.com","path":"/","secure":false,"value":"4072127475","key":"__cflb"}],"responseTime":null,"body":"{\"code\":\"701\",\"message\":\"INVALID_CREDENTIALS\",\"description\":\"Identifiant de connexion incorrect\",\"data\":[]}"},{"id":"d7a83154-d0e5-47fa-80e5-1953b37ef4d6","name":"Exemple resultat : Succès","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","disabled":false}],"body":{"mode":"urlencoded","urlencoded":[{"key":"apikey","value":"your_apikey_here","type":"text"},{"key":"password","value":"your_password_here","type":"text"}]},"url":"https://client.cinetpay.com/v1/auth/login "},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Headers","value":"X-Requested-With, Content-Type, X-Auth-Token, Origin, Authorization","name":"Access-Control-Allow-Headers","description":"Used in response to a preflight request to indicate which HTTP headers can be used when making the actual request."},{"key":"Access-Control-Allow-Methods","value":"GET,POST","name":"Access-Control-Allow-Methods","description":"Specifies the method or methods allowed when accessing the resource. This is used in response to a preflight request."},{"key":"Access-Control-Allow-Origin","value":"*","name":"Access-Control-Allow-Origin","description":"Specifies a URI that may access the resource. For requests without credentials, the server may specify '*' as a wildcard, thereby allowing any origin to access the resource."},{"key":"Access-Control-Expose-Headers","value":"api.client.transfert","name":"Access-Control-Expose-Headers","description":"Lets a server whitelist headers that browsers are allowed to access."},{"key":"CF-RAY","value":"430780a428d23dcb-MXP","name":"CF-RAY","description":"Custom header"},{"key":"Cache-Control","value":"private, must-revalidate","name":"Cache-Control","description":"Tells all caching mechanisms from server to client whether they may cache this object. It is measured in seconds"},{"key":"Connection","value":"keep-alive","name":"Connection","description":"Options that are desired for the connection"},{"key":"Content-Encoding","value":"gzip","name":"Content-Encoding","description":"The type of encoding used on the data."},{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"The mime type of this content"},{"key":"Date","value":"Mon, 25 Jun 2018 12:40:25 GMT","name":"Date","description":"The date and time that the message was sent"},{"key":"Expect-CT","value":"max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"","name":"Expect-CT","description":"Custom header"},{"key":"Server","value":"cloudflare","name":"Server","description":"A name for the server"},{"key":"Transfer-Encoding","value":"chunked","name":"Transfer-Encoding","description":"The form of encoding used to safely transfer the entity to the user. Currently defined methods are: chunked, compress, deflate, gzip, identity."},{"key":"X-Powered-By","value":"Tomcat 7.0.77","name":"X-Powered-By","description":"Specifies the technology (ASP.NET, PHP, JBoss, e.g.) supporting the web application (version details are often in X-Runtime, X-Version, or X-AspNet-Version)"},{"key":"X-Powered-By","value":"PleskLin","name":"X-Powered-By","description":"Specifies the technology (ASP.NET, PHP, JBoss, e.g.) supporting the web application (version details are often in X-Runtime, X-Version, or X-AspNet-Version)"},{"key":"X-RateLimit-Limit","value":"60","name":"X-RateLimit-Limit","description":"Custom header"},{"key":"X-RateLimit-Remaining","value":"59","name":"X-RateLimit-Remaining","description":"Custom header"},{"key":"expires","value":"-1","name":"expires","description":"Gives the date/time after which the response is considered stale"},{"key":"pragma","value":"no-cache","name":"pragma","description":"Implementation-specific headers that may have various effects anywhere along the request-response chain."}],"cookie":[{"expires":"Tue Jan 22 2019 11:28:44 GMT+0000 (Coordinated Universal Time)","httpOnly":true,"domain":"cinetpay.com","path":"/","secure":false,"value":"d971d0b5c105040d409c62283da4ed9251516620524","key":"__cfduid"},{"expires":"Tue Jun 26 2018 11:18:57 GMT+0000 (Coordinated Universal Time)","httpOnly":false,"domain":"client.cinetpay.com","path":"/","secure":false,"value":"4072127475","key":"__cflb"}],"responseTime":null,"body":"{\n \"code\": 0,\n \"message\": \"OPERATION_SUCCES\",\n \"data\": {\n \"token\": \"XXX_TOKEN_XXX\"\n }\n}"}],"_postman_id":"d1bdbdf5-a779-41ce-a3f7-65eb551b8195"},{"name":"Solde du compte transfert / Transfer Account Information","id":"a1dfc2a8-0487-4f6b-a15a-fc186845587f","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://client.cinetpay.com/v1/transfer/check/balance/?token=your_token_here&lang=fr","description":"French : Une fois que vous avez le token, vous pouvez l'insérer en GET pour avoir votre solde transfert\nEnglish : Once you have the token, you can insert it in GET for having your balance's account transfer
\n","urlObject":{"protocol":"https","path":["v1","transfer","check","balance",""],"host":["client","cinetpay","com"],"query":[{"key":"token","value":"your_token_here"},{"key":"lang","value":"fr"}],"variable":[]}},"response":[],"_postman_id":"a1dfc2a8-0487-4f6b-a15a-fc186845587f"},{"name":"Ajouter un ou plusieurs contacts sur CinetPay / Add one or more contacts to CinetPay","id":"d1b265a8-430a-472b-bead-01edc85b9473","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"data","value":"[{\n \"prefix\": \"225\",\n \"phone\": \"53798590\",\n \"name\": \"Test A\",\n \"surname\": \"Test B\",\n \"email\": \"testa@exemple.com\"\n}, {\n \"prefix\": \"225\",\n \"phone\": \"77895086\",\n \"name\": \"Test C\",\n \"surname\": \"Test D\",\n \"email\": \"testb@exemple.com\"\n}]","type":"text"}]},"url":"https://client.cinetpay.com/v1/transfer/contact?token=your_token_here&lang=fr","description":"French : Pour effectuer un transfert d'argent sur un numéro de téléphone, il doit figurer au préalable dans votre liste de contact. Utilisez ce lien pour ajouter un ou plusieurs contacts;\nDonnées en POST :\ndata : la liste des contacts à ajouter
\nEnglish : To transfer money to a phone number, it must be in your contact list before. Use this link to add one or more contacts;\nPOST data:\ndata: the list of contacts to add
\n","urlObject":{"protocol":"https","path":["v1","transfer","contact"],"host":["client","cinetpay","com"],"query":[{"key":"token","value":"your_token_here"},{"key":"lang","value":"fr"}],"variable":[]}},"response":[],"_postman_id":"d1b265a8-430a-472b-bead-01edc85b9473"},{"name":"Envoyer de l'argent d'un ou plusieurs de vos contacts / Send money from one or more of your CinetPay contacts","id":"bcce7272-9e82-40bf-b3c7-e184c1edc19e","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"data","value":"[{\n \"prefix\": \"225\",\n \"phone\": \"07895086\",\n \"amount\" : \"500\",\n \"notify_url\": \"https://mydomain.com/notify\",\n \"client_transaction_id\": \"MYMERCHANTID1\"\n}, {\n \"prefix\": \"225\",\n \"phone\": \"07895086\",\n \"amount\" : \"800\",\n \"notify_url\": \"https://mydomain.com/notify\",\n \"client_transaction_id\": \"20180606111287\"\n}]","type":"text"}]},"url":"https://client.cinetpay.com/v1/transfer/money/send/contact?token=your_token_here&lang=fr","description":"French : Vous pouvez initier un ordre de transfert d'argent vers un numéro de téléphone de vos contacts. Vous devez confirmer le transfert par mail.\nTous les transferts d'argents doivent être confirmer par le marchand. Si vous voulez que cela soit prise en compte sans validation. Veuillez écrire à CinetPay et nous fournir une liste d'adresses IP qui pourront effectuer des ordres de transfert\nEnglish : you can initiate a payout to a mobile number of your contacts. You must confirm the transfer by mail\nEvery payout must be confirmed by merchant (mail confirm). If you want to bypass it, you must ask it to CinetPay and provide us a list of IPs that will be able to initiate a payout
\n","urlObject":{"protocol":"https","path":["v1","transfer","money","send","contact"],"host":["client","cinetpay","com"],"query":[{"key":"token","value":"your_token_here"},{"key":"lang","value":"fr"}],"variable":[]}},"response":[],"_postman_id":"bcce7272-9e82-40bf-b3c7-e184c1edc19e"},{"name":"Avoir les informations d'un transfert d'argent / Get information about a payout","id":"3f43218d-22ee-4028-8470-12561449ab3e","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://client.cinetpay.com/v1/transfer/check/money?token=your_token_here&client_transaction_id=my_transaction_id&lang=fr","description":"French : Ceci vous permet d'avoir les informations sur un transfert d'argent\nEn GET, vous pouvez envoyer \"transaction_id\" correspondant CinetPay transaction ID OU \"client_transaction_id\" (Votre transaction ID)\nEnglish : This allows you to have information about a payout\nIn GET, you can send \"transaction_id\" (CinetPay ID Transaction) or \"client_transaction_id\" (Your ID Transaction)
\n","urlObject":{"protocol":"https","path":["v1","transfer","check","money"],"host":["client","cinetpay","com"],"query":[{"key":"token","value":"your_token_here"},{"key":"client_transaction_id","value":"my_transaction_id"},{"key":"lang","value":"fr"}],"variable":[]}},"response":[],"_postman_id":"3f43218d-22ee-4028-8470-12561449ab3e"}],"event":[{"listen":"prerequest","script":{"id":"ffabdd08-1ecc-4e77-a19f-0f51ff6f4888","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"1008fc2a-9b1c-482f-bb0c-2a4373963636","type":"text/javascript","exec":[""]}}]}