You are on page 1of 37

Partner Name

API Documentation

Digest authentification

Transaction fixed parameters TouchPay (PayIn)

Back Office access

****Notice : passwordAgent = password_api you will receive one email for both
Parameters name

Developer Portal

Username
Password

Agency Code
loginAgent
passwordAgent
SecureCode (for TouchPay Web only)

URL Access
Login
Password
CABINET LAHASSA GN

https://developers.intouchgroup.net/

3eb5c568b6256e6bb13da0727097b468f29c047c9720e1dc0207429e5a8fbdcb
789f223019285a6c7fe46d32690752a802ebff7349ab1355b59c7fba1051ccee

CLIGN4523
666989064
Sent to
bX9rV2rLFbST9NqeiDu6dChx3pA06F0c2yFb9fiY5WRBSUYcnG

https://bo.gutouch.com/bo/partener/authentification/authentification.zul

Sent to jay.allen01@yahoo.com on 09/04 at 13H54


Pay In (collection)
Orange Money
MTN

Pay Out (Send money to a wallet)


Orange Money
MOOV
TOUCHCASH
serviceCode
PAIEMENTMARCHANDOMPAYGNDIRECT
PAIEMENTMARCHAND_MTN_GN

service_id
GN_CASHIN_OM_PART
GN_CASHIN_MTN_PART
GN_SEND_TP
Test #
APPLICATION 1: 
1
2

APPLICATION 2: 
1

APPLICATION 3: 
1

APPLICATION 4: 
1

APPLICATION 4: 
1
2

General Questions/Comments
Description of tasks
LICATION 1: 

cases where all the information is correct

LICATION 2: 

In the case where either the password_api, pixi code, agency code, login_api, partner_transaction_id, or amount are incorrect

LICATION 3: 

In case the service code entered is incorrect

LICATION 4: 

In case there is an error on the url 

LICATION 4: 

In case where  the recipient's number is not valid. 


In case where  the recipient's number is not valid. 

ral Questions/Comments
Exemple JSON

 {  "idFromClient": "15487071111452311069773",   "additionnalInfos": {    "recipientEmail":"junior@gmail.com",    "recipientFirstName": "User",    "reci

 {  "idFromClient": "15487071111452311069773",   "additionnalInfos": {    "recipientEmail":"junior@gmail.com",    "recipientFirstName": "User",    "reci

 {  "idFromClient": "15487071111452311069773",   "additionnalInfos": {    "recipientEmail":"junior@gmail.com",    "recipientFirstName": "User",    "reci

 {  "idFromClient": "15487071111452311069773",   "additionnalInfos": {    "recipientEmail":"junior@gmail.com",    "recipientFirstName": "User",    "reci

 {  "idFromClient": "15487071111452311069773",   "additionnalInfos": {    "recipientEmail":"junior@gmail.com",    "recipientFirstName": "User",    "reci


 {  "idFromClient": "15487071111452311069773",   "additionnalInfos": {    "recipientEmail":"junior@gmail.com",    "recipientFirstName": "User",    "reci
Steps To Execute Code

«  idFromClient » : put the id of the transaction


« recipientEmail » : put the email of agent

« recipientFirstName » : put the first name of agent

« recipientLastName » : put the last name of agent


200
« destinataire » : put the recipient’s number

« amount » : put the amount to be sent

« recipientNumber » : put the agent’s number

«  idFromClient » : put the id of the transaction

« recipientEmail » : put the email of agent

« recipientFirstName » : put the first name of agent

« recipientLastName » : put the last name of agent


300
« destinataire » : put the recipient’s number

« amount » : put the amount to be sent

« recipientNumber » : put the agent’s number

«  idFromClient » : put the id of the transaction

« recipientEmail » : put the email of agent

« recipientFirstName » : put the first name of agent

« recipientLastName » : put the last name of agent


401
« destinataire » : put the recipient’s number

« amount » : put the amount to be sent

« recipientNumber » : put the agent’s number

«  idFromClient » : put the id of the transaction

« recipientEmail » : put the email of agent

« recipientFirstName » : put the first name of agent

« recipientLastName » : put the last name of agent


404
« destinataire » : put the recipient’s number

« amount » : put the amount to be sent

« recipientNumber » : put the agent’s number

«  idFromClient » : put the id of the transaction

300
« recipientEmail » : put the email of agent

« recipientFirstName » : put the first name of agent

« recipientLastName » : put the last name of agent


300
« destinataire » : put the recipient’s number

« amount » : put the amount to be sent

« recipientNumber » : put the agent’s number


Expected Results Pass Fail

{   "idFromClient": "15487071111452311069773",   "idFromGU": "1562252064444",   "amount": 10.0,   "fees": 0.125,   "serviceCode": "PAIEMENTMAR

{   "status": 300,   "message": "(500) clientPhone: NOT A VALID PHONE NUMBER" }

{   "status": 401,   "message": "(401) The agent is not authorized to initiate a transaction of the service" }

{   "code": 404,   "contactEmail": null,   "description": "The server has not found anything matching the request URI",   "homeRef": "/",   "reasonPhrase": "

{   "status": 300,   "message": "(500) clientPhone: NOT A VALID PHONE NUMBER" }


{   "status": 300,   "message": "(500) clientPhone: NOT A VALID PHONE NUMBER" }
Defect/Comments/Additions
Test #Description of tasks
APPLICATION 1: 
1

2 cases where all the information is correct


3

7
APPLICATION 2: 
1

Cases that the client's partner_id is duplicated, it must be unique. T


2
3
4

6
7
APPLICATION 3: 
1

In the case where either the password_api, pixi code, agency code, lo
2
3
4

7
APPLICATION 4: 
1

In case the service code entered is incorrect


2
3
4

6
7
APPLICATION 5: 
1

In the case where the agency's balance is less than the amount of the s
2
3
4

7
APPLICATION 6: 
1

In case there is an error on the url


2
3
4

6
7
APPLICATION 7: 
1

In case where  the recipient's number is not valid.


2
3
4

7
General Questions/Comments
Exemple JSON Steps To Execute

 {  
   "service_id":"BF_CASHIN_OM_PART",
   "recipient_phone_number" : "781833456", 
   "amount":1200,
   "partner_id":"ZZ0001",  
« service_id » : put the airtime service
   "partner_transaction_id":"2372443621187161410226472",
   "login_api":"777894561",  
   "password_api":"0000","call_back_url":"https://e870adf3.ngrok.io" 
 }

« recipient_phone_number » : put the r


« amount » : put the amount to be sent

« partner_id » : put the PDA code

« partner_transaction_id » : change the

« login_api » : put the the agent's login

« password_api » : put the agent passw

 {  
   "service_id":"BF_CASHIN_OM_PART",
   "recipient_phone_number" : "781833456", 
   "amount":1200,
   "partner_id":"ZZ0001",  
« service_id » : put the airtime service
   "partner_transaction_id":"2372443621187161410226472",
   "login_api":"777894561",  
   "password_api":"0000",   
   "call_back_url":"https://e870adf3.ngrok.io" 
 }
« recipient_phone_number » : put the r
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the

« login_api » : put the the agent's login


« password_api » : put the agent passw

 {  
  "service_id":"BF_CASHIN_OM_PART",  
  "recipient_phone_number":"781833456", 
  "amount":100, 
  "partner_id":"ZZ0001", 
« service_id » : put the airtime service
  "partner_transaction_id":"277224127814888612", 
  "login_api":"777894561", 
  "password_api":"0007", 
  "call_back_url":"https://e870adf3.ngrok.io"  
}
« recipient_phone_number » : put the r
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the

« login_api » : put the the agent's login

« password_api » : put the agent passw

 {
  "service_id":"BF_CASHIN_OM_PART", 
  "recipient_phone_number":"781833456", 
  "amount":100, 
  "partner_id":"ZZ0001", 
« service_id » : put the airtime service
  "partner_transaction_id":"237221886111424564772",      
  "login_api":"777894561", 
  "password_api":"0000", 
  "call_back_url":"https://e870adf3.ngrok.io"
}
« recipient_phone_number » : put the r
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the

« login_api » : put the the agent's login


« password_api » : put the agent passw

 {
 "service_id":"BF_CASHIN_OM_PART",  
  "recipient_phone_number":"781833456",  
  "amount":7000, 
  "partner_id":"ZZ0001", 
« service_id » : put the airtime service
  "partner_transaction_id":"177112236012", 
  "login_api":"777894561", 
  "password_api":"0000", 
  "call_back_url":"https://e870adf3.ngrok.io"
}

« recipient_phone_number » : put the r


« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the

« login_api » : put the the agent's login

« password_api » : put the agent passw

 {
 "service_id":"BF_CASHIN_OM_PART",  
  "recipient_phone_number":"781833456",  
  "amount":7000, 
  "partner_id":"ZZ0001", 
« service_id » : put the airtime service
  "partner_transaction_id":"177112236012", 
  "login_api":"777894561", 
  "password_api":"0000", 
  "call_back_url":"https://e870adf3.ngrok.io"
}

« recipient_phone_number » : put the r


« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the

« login_api » : put the the agent's login


« password_api » : put the agent passw

 {
 "service_id":"BF_CASHIN_OM_PART",  
  "recipient_phone_number":"",  
  "amount":7000, 
  "partner_id":"ZZ0001", 
« service_id » : put the airtime service
  "partner_transaction_id":"177112236012", 
  "login_api":"777894561", 
  "password_api":"0000", 
  "call_back_url":"https://e870adf3.ngrok.io"
}

« recipient_phone_number » : put the r


« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the

« login_api » : put the the agent's login

« password_api » : put the agent passw


Steps To Execute Code

« service_id » : put the airtime service code

« recipient_phone_number » : put the recipient's number 200


« amount » : put the amount to be sent

« partner_id » : put the PDA code

« partner_transaction_id » : change the token of the transaction

« login_api » : put the the agent's login

« password_api » : put the agent password

« service_id » : put the airtime service code

300
« recipient_phone_number » : put the recipient's number
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the token of the transaction

« login_api » : put the the agent's login


« password_api » : put the agent password

« service_id » : put the airtime service code

400
« recipient_phone_number » : put the recipient's number
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the token of the transaction

« login_api » : put the the agent's login

« password_api » : put the agent password

« service_id » : put the airtime service code

401
« recipient_phone_number » : put the recipient's number
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the token of the transaction

« login_api » : put the the agent's login


« password_api » : put the agent password

« service_id » : put the airtime service code

403
« recipient_phone_number » : put the recipient's number
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the token of the transaction

« login_api » : put the the agent's login

« password_api » : put the agent password

« service_id » : put the airtime service code

404
« recipient_phone_number » : put the recipient's number
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the token of the transaction

« login_api » : put the the agent's login


« password_api » : put the agent password

« service_id » : put the airtime service code

422
« recipient_phone_number » : put the recipient's number
« amount » : put the amount to be sent
« partner_id » : put the PDA code

« partner_transaction_id » : change the token of the transaction

« login_api » : put the the agent's login

« password_api » : put the agent password


Expected Results Pass Fail Defect/Comm

{
  "service_id": "AIRTIMEORANGE",
  "gu_transaction_id": "1561546326036",
  "status": "PENDING",
  "transaction_date": "2019/06/26 10:52:06 AM",
  "recipient_phone_number": "781833456",
  "amount": 1200.0,
  "partner_transaction_id": "23721443621861410226472",
  "message": null
}

{
  "status": 300, 
  "message": "(204) Engine error" 
}

  "service_id": null,  
  "gu_transaction_id": null,  
  "status": "FAILED", 
  "transaction_date": null, 
  "recipient_phone_number": null, 
  "amount": null, 
  "partner_transaction_id": null,  
  "message": null
}


  "service_id": "AIRTIMEORANG2",   
  "gu_transaction_id": "1561541622282",  
  "status": "FAILED",  
   "transaction_date": null,   
  "recipient_phone_number": "781833456",   
  "amount": 100.0,  
  "partner_transaction_id": "237221886111424564772",   
  "message": null
}

  "service_id": "AIRTIMEORANGE",   
  "gu_transaction_id": "1561480730525",   
  "status": "FAILED",   
  "transaction_date": null,   
  "recipient_phone_number": "781833456",   
  "amount": 7000.0,   
  "partner_transaction_id": "177112236012",   
  "message": null
}

{
      "code": 404,
"contactEmail": null,
"description": "The server has not found anything matching the request URI",
"homeRef": "/",
"reasonPhrase": "Not Found",
"uri" :  "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5"
}
{  
  "service_id": null,   
  "gu_transaction_id": null,   
  "status": "FAILED",   
  "transaction_date": null,   
  "recipient_phone_number": null,   
  "amount": null,   
  "partner_transaction_id": null,   
  "message": null
}
Defect/Comme

You might also like