Authorize Transaction<\/strong>
\nAuthorize Transaction message is used to send a transaction authorization to a MMO.<\/p>\n

Authorize Transaction Request<\/strong>
\nThe following describes the important element required to be sent for Authorize Transaction request. The HTTP method is POST.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S\/N <\/strong><\/td>\n	Data Element (DE) <\/strong><\/td>\n	\u00a0<\/strong><\/td>\n	Description <\/strong><\/td>\n<\/tr>\n
1<\/td>\n	subscriberId<\/td>\n	Mandatory<\/td>\n	Customer ID. E.g. 2348012233220<\/td>\n<\/tr>\n
2<\/td>\n	transactionId<\/td>\n	Mandatory<\/td>\n	Unique ID for the transaction<\/td>\n<\/tr>\n
3<\/td>\n	transactionType<\/td>\n	Mandatory<\/td>\n	Transaction Type<\/td>\n<\/tr>\n
4<\/td>\n	providerToken<\/td>\n	Mandatory<\/td>\n	Mobile Money Transaction Authentication Token.<\/p>\n NB: Null is sent and should be used if providerToken is not sent generate token request.<\/strong><\/td>\n<\/tr>\n
5<\/td>\n	Narration<\/td>\n	Mandatory<\/td>\n	Transaction narration<\/td>\n<\/tr>\n
6<\/td>\n	mercantId<\/td>\n	Mandatory<\/td>\n	Merchant Identifier<\/td>\n<\/tr>\n
7<\/td>\n	terminalId<\/td>\n	Mandatory<\/td>\n	Mobile Money Transaction Authentication Token<\/td>\n<\/tr>\n
8<\/td>\n	Amount<\/td>\n	Mandatory<\/td>\n	Transaction Amount in lower denomination<\/td>\n<\/tr>\n
9<\/td>\n	Acquirer<\/td>\n	Mandatory<\/td>\n	Acquirer<\/td>\n<\/tr>\n
10<\/td>\n	macdata<\/td>\n	Mandatory<\/td>\n	See the MAC computation in the appendix<\/td>\n<\/tr>\n
11<\/td>\n	paycode<\/td>\n	Mandatory<\/td>\n	PayWithMobile Token<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Request Headers<\/strong><\/p>\n\n\n\n\n\n S\/N <\/strong><\/td>\n Data Element (DE) <\/strong><\/td>\n \u00a0<\/strong><\/td>\n Description <\/strong><\/td>\n<\/tr>\n 1<\/td>\n Authorization<\/td>\n Mandatory<\/td>\n Basic Authentication will be used. E.g Basic dXNlcm5hbWU6cGFzc3dvcmQ=. The username and<\/p>\n Password for basic authentication is to be provided by<\/p>\n MMO<\/td>\n<\/tr>\n 2<\/td>\n Content-Type<\/td>\n Mandatory<\/td>\n The API should support \u201capplication\/json\u201d media type<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n <\/p>\n Sample Authorize Transaction Request (Sent from Interswitch)<\/strong><\/p>\n\n\n\n POST {context}\/transactions\/authorize<\/p>\n Content-Type: application\/json<\/p>\n Authorization: dXNlcm5hbWU6cGFzc3dvcmQ=<\/p>\n Signature: SUtJQTc2QzYzQjYwODIxNjI5RjRDQ0I5MDQ3RjRFNzI5NzUyMjJGMENENzc=<\/p>\n \n {<\/div>\n “subscriberId”:\u00a0“2348060774043”,<\/div>\n “transactionId”:\u00a0“123456”,<\/div>\n “providerToken”:\u00a0“null”,<\/div>\n “transactionType”:\u00a0“withdrawal”,<\/div>\n “narration”:\u00a0“ABC1234567”,<\/div>\n “amount”:\u00a0“00000010000”,<\/div>\n “merchantId”:\u00a0“ttt3244”,<\/div>\n “terminalId”:\u00a0“234455555”,<\/div>\n “acquirer”:\u00a0“12344453”,<\/div>\n “macdata”:\u00a0“JgUGs+L\/G2DsC8q0mn7CEKozmukVCIFnmKO5bGugZdQ<\/div>\n gIS7RmEMtY3Nv6xR9AJaurAiBqxttckUZXpWOC3g3\/w==”,<\/div>\n <\/div>\n “paycode”:\u00a0“12601609197”<\/div>\n <\/div>\n<\/div>\n }<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Authorize Transaction Response\u00a0<\/strong> \nThe following describes the important data element required for Authorize Transaction response.<\/p>\n\n\n\n\n\n S\/N <\/strong><\/td>\n Data Element (DE) <\/strong><\/td>\n Description <\/strong><\/td>\n<\/tr>\n 1<\/td>\n responseCode<\/td>\n Response Code. See Response Code Table Below<\/td>\n<\/tr>\n 2<\/td>\n responseDecription<\/td>\n Response Description. See Response Code Table Below<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Successful Response<\/strong><\/p>\n\n\n\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 HTTP Status Code:\u00a0 200<\/p>\n Content-Type: application\/json<\/p>\n {<\/p>\n “responseCode”: “00”,<\/p>\n “responseDescription”: “Authorized\u201d<\/p>\n }<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Unsuccessful Response<\/strong><\/p>\n\n\n\n HTTP Status Code:\u00a0 401<\/p>\n Content-Type: application\/json<\/p>\n {<\/p>\n “responseCode”: “63”,<\/p>\n “responseDescription”: “Security Violation\u201d<\/p>\n }<\/p>\n HTTP Status Code:\u00a0 500<\/p>\n Content-Type: application\/json<\/p>\n {<\/p>\n “responseCode”: “06”,<\/p>\n “responseDescription”: “Unable to authorize due to some errors\u201d<\/p>\n }<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","protected":false},"author":169,"featured_media":0,"parent":1043,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"spay_email":""},"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1047"}],"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\/169"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=1047"}],"version-history":[{"count":6,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1047\/revisions"}],"predecessor-version":[{"id":4106,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1047\/revisions\/4106"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1043"}],"next":[{"title":"ReverseTransaction","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/paycode\/transaction-authorization-mmo\/reversetransaction\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1048"}],"prev":[{"title":"Introduction","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/paycode\/transaction-authorization-mmo\/introduction\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1044"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=1047"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=1047"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}