Validate Token<\/strong><\/h2>\n\n\n\n

This endpoint handles the validation of tokens on Cardless. This endpoint should be called during the cashout process. to validate the token before attempting a cashout.<\/p>\n\n\n\n

Request Message description<\/h4>\n\n\n\n

Field#<\/th>	Field name<\/th>	Data type<\/th>	Max length<\/th>	Required<\/th>	Description<\/th><\/tr>
1<\/td>	frontEndPartner<\/td>	string<\/td>	<\/td>	yes<\/td>	Front end partner code to identify client on cardless<\/td><\/tr>
2<\/td>	agentId<\/td>	string<\/td>	<\/td>	yes<\/td>	Agent network’s agent Identifier<\/td><\/tr>
3<\/td>	domainCode<\/td>	string<\/td>	<\/td>	yes<\/td>	Domain code set up on ISW CORE<\/td><\/tr>
4<\/td>	tokenHash<\/td>	string<\/td>	<\/td>	yes<\/td>	SHA512 hash of the token.<\/td><\/tr>
5<\/td>	amount<\/td>	long<\/td>	<\/td>	yes<\/td>	(in minor denomination)<\/td><\/tr>
6<\/td>	oneTimePin<\/td>	string<\/td>	<\/td>	yes<\/td>	4 digit PIN<\/td><\/tr>
7<\/td>	channel<\/td>	string<\/td>	<\/td>	yes<\/td>	AGENT is the only acceptable channel for this API<\/td><\/tr>
13<\/td>	paymentMethodTypeCode<\/td>	string<\/td>	<\/td>	yes<\/td>	MMO is the only acceptable for this channel<\/td><\/tr><\/tbody><\/table>\n\n\n\n POST \/cardless-service\/api\/v3\/cardless-services\/transactions\/validate\n<\/td><\/tr><\/tbody><\/table>\n\n\n\n <enter headers below> <\/p>\n\n\n\n Accept application\/json\nContent-Type application\/json\nAuthorization Bearer <access_token><\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Request<\/h5>\n\n\n\n <enter sample request below> <\/p>\n\n\n\n {\n “frontEndPartner” : “codecsystems”,\n\t“agentId”: “SMX001”,\n\t“domainCode” : “RCG”,\n\t“tokenHash” : “f6b6810ad6077d7c900d3f665e21f35fd488508ba2544122e6e0f13625a75ccdfc01e94e37a9d4e7d4a522ac026d2f71c1ed28e83b086645533f59c07d0deba3”,\n\t“amount” : “100000”,\n\t“oneTimePin” : “1234”,\n\t“channel” : “AGENT”,\n\t“paymentMethodTypeCode”: “MMO”\n}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (success)<\/h5>\n\n\n\n <enter sample response(success) below> <\/p>\n\n\n\n {\n “code”: “00”,\n “description”: “Approved or completed successfully”\n}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (failure)<\/h5>\n\n\n\n <enter sample response(failure) below> <\/p>\n\n\n\n {\n “code”: “12”,\n “description”: “Invalid transaction”\n}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Response Codes<\/h4>\n\n\n\n <Enter field description for response><\/p>\n\n\n\n Field#<\/th> Field name<\/th> Description<\/th><\/tr> 1<\/td> 400524<\/td> Invalid Front End Partner<\/td><\/tr> 2<\/td> 400523<\/td> Invalid Domain Code<\/td><\/tr> 3<\/td> 58<\/td> Transaction not permitted on terminal<\/td><\/tr> 4<\/td> 12<\/td> Invalid transaction<\/td><\/tr> 5<\/td> 75<\/td> PIN tries exceeded<\/td><\/tr> 6<\/td> 13<\/td> Invalid Amount<\/td><\/tr> 7<\/td> 55<\/td> Invalid PIN<\/td><\/tr> 8<\/td> 00<\/td> Approved or completed successfully<\/td><\/tr><\/tbody><\/table>\n\n\n\n Notification<\/h2>\n\n\n\n This endpoint is to notify cardless system whether to close the paycode or not. If cashout was successful at client’s end, then 0 should be passed as status, otherwise 1 should be passed as status.<\/p>\n\n\n\n Request Message description<\/h4>\n\n\n\n <Enter field description for request below><\/p>\n\n\n\n Field#<\/th> Field name<\/th> Data type<\/th> Max length<\/th> Required<\/th> Description<\/th><\/tr> <\/td> frontEndPartner<\/td> string <\/td> <\/td> yes<\/td> Front end partner code to identify client on cardless<\/td><\/tr> 1<\/td> tokenHash<\/td> string<\/td> <\/td> yes<\/td> SHA512 hash of the token.<\/td><\/tr> 2<\/td> status<\/td> int<\/td> <\/td> yes<\/td> 0 to close transaction, 1 to re-open.<\/td><\/tr> 3<\/td> agentId<\/td> string<\/td> <\/td> yes<\/td> Agent network’s agent Identifier<\/td><\/tr> 4<\/td> domainCode<\/td> string<\/td> <\/td> yes<\/td> Domain code set up on ISW CORE<\/td><\/tr><\/tbody><\/table>\n\n\n\n <enter endpoint below> <\/p>\n\n\n\n POST \/cardless-service\/api\/v3\/cardless-services\/transactions\/notify\n<\/td><\/tr><\/tbody><\/table>\n\n\n\n <enter headers below> <\/p>\n\n\n\n Accept application\/json\nContent-Type application\/json\nAuthorization Bearer <access_token><\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Request<\/h5>\n\n\n\n <enter sample request below> <\/p>\n\n\n\n {\n\t“frontEndPartner” : “codecsystems”,\n “tokenHash” :”38111b2b4a413f5e5fb31e398de2f1714761daaef3629e47483b0615f6d535a796d634319e62b85ddcc449848e7df75f1f83e086c29cb1ce017bad662b33a764″,\n\t“status”: 0,\n\t“agentId” : “SMX001”,\n\t“domainCode”: “RCG”\n}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (success)<\/h5>\n\n\n\n <enter sample response(success) below> <\/p>\n\n\n\n {\n “code”: “00”,\n “description”: “Completed successfully”\n}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (failure)<\/h5>\n\n\n\n <enter sample response(failure) below> <\/p>\n\n\n\n {\n “code”: “12”,\n “description”: “Invalid transaction”\n}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Response Codes<\/h4>\n\n\n\n <Enter field description for response><\/p>\n\n\n\n Field#<\/th> Field name<\/th> Description<\/th><\/tr> 1<\/td> 400523<\/td> Invalid Domain Code<\/td><\/tr> 2<\/td> 400524<\/td> Invalid Front End Partner<\/td><\/tr> 3<\/td> 400525<\/td> Invalid Issuing Front End Partner<\/td><\/tr> 4<\/td> 400526<\/td> Invalid Issuing Domain Code<\/td><\/tr> 5<\/td> 400527<\/td> Transaction not found or Transaction already closed<\/td><\/tr> 6<\/td> 06<\/td> Error logging settlement request.<\/td><\/tr> 7<\/td> 00<\/td> Completed successfully.<\/td><\/tr><\/tbody><\/table>\n","protected":false},"author":4618,"featured_media":0,"parent":360,"menu_order":8,"comment_status":"open","ping_status":"closed","template":"","meta":{"spay_email":""},"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4260"}],"collection":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/users\/4618"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=4260"}],"version-history":[{"count":2,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4260\/revisions"}],"predecessor-version":[{"id":4264,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4260\/revisions\/4264"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/360"}],"next":[{"title":"FAQ","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/paycode\/faq\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1411"}],"prev":[{"title":"Transaction Authorization (MMO)","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/paycode\/transaction-authorization-mmo\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1043"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=4260"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=4260"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}