Visa card transactions unlike Verve card and Mastercard card transitions require cardinal validation. Payment transaction requires Cardinal when ResponseCode is S0<\/p>\n

To accept payment with Card that requires cardinal use this end point to make your request.<\/p>\n

POST \/api\/v3\/purchases<\/pre>\n
Sample Request<\/span><\/strong><\/span><\/p>\n
To make payment with card that requires cardinal, set up your payment request like this.<\/p>\n
{\n    \"customerId\": \"1407002510\",                                                       \/\/ Email, mobile number, BVN etc to uniquely identify the customer.\n    \"amount\": \"200\",                                                                  \/\/ Amount in naira.\n    \"transactionRef\": \"ESBDEV10003\",                                                  \/\/ Unique transaction reference number.\n    \"currency\":\"NGN\",                                                                 \/\/ ISO Currency code.\n    \"authData\":\"AMZtxiP2Jxx5PjYnM+YbtxMt56j\/0cfaqo27oCTEa7ifuONNODvmshDVLYdSl0YZ41dETsI1ZgzRy6i\n YvPUZ0g2E41AU4wAcmU55sFsuEyAfuHWVrw\/sOuyBtg\/vO9k1Khv\/KPNHw\/bg8GvmWPclS1Ti4V01sMkEdjGDX3L3geh05\n fCHrk8\/Z8VHOLMHQ4v9sKbsrwzglS9qBRTqHhfYmayG2+s4j3KE82hPeK\/6trxtvJ0vCE6h2\/UOyxaD+WjtrQblSW\/g8Cp\n yhw3AkE9JR14bNxQXQWCeWI1obwPcGHE04gsKFLekBIjFqKlszMXHlkevBHgdSHnexbWjtj\/O6Q==\"       \/\/ Auth data.\n}\n<\/pre>\n
<\/h5>\n
Sample Response (success)<\/strong><\/span><\/h5>\n
After payment request has been sent, the expected successful payment response is similar to this.<\/p>\n
{\n  \"paymentId\": \"66603\",                                                                   \/\/ Payment Identifier.\n  \"responseCode\": \"S0\",                                                                   \/\/ Response Code.\n  \"amount\": \"200.00\",                                                                     \/\/ Amount in Naira.\n  \"transactionRef\": \"ESBDEV10003\",                                                        \/\/ Uniques transaction reference number.\n  \"transactionId\": \"MSPjKBV2Kyg91MQRMep0\",                                                \/\/ Transaction unique identifier.\n  \"eciFlag\": \"07\",                                                                        \/\/ The Electronic Commerce Indicator (ECI) Flag e.g Visa:05: Issuer Liability, \n                                                                                          \/\/ 06: Issuer Liability, 07: Merchant Liability.\n  \"MD\": \"66603\",                                                                          \/\/ Merchant's session tracker. Set to blank if not used.\n  \"ACSUrl\": \"https:\/\/testcustomer34.cardinalcommerce.com\/V3DSStart?osb=visa-3&VAA=B\",     \/\/ This is the URL to which your application must next send the cardholder to complete authentication.\n  \"TermUrl\": \"https:\/\/sandbox.interswitchng.com\/collections\/api\/v1\/pay\/cardinalCallBack\",      \/\/ The URL for handling and processing the response from the ACSUrl.\n  \"PaReq\": \"eNpVUttu4jAQffdXoH5AbOeCtGhqKQVp2+2GpmlL9zU4s2AgTuo4Bf6+doBe3uacuficGcPz2iDOnlD2BgVk2HXlCkequr7Knv\n LN\/c0ivD+ufvHssciwZVcC8rTANwHvaDrVaMEDFoRAL5C4EUauS20FlPLt5m4u4jiOogjoGRKo0dzNBA+jOBkDPSECuqxRpBXaXm+UGqVbpSs\n EOtAEZNNra44iGbuWCyDQm51YW9tOKN3jsi2PgdLWSdkrK9d6Fcimpo6tlEFpaYV1A9T3EKBfOvPeR52zf1CVeF7MH8utnS42f\/7iq0yyF168\n bPlOztJroL6CQFVaFCHjY5aE0YjzScInPAY68ATK2gsU89\/zUchYwJgzf6IItP6x9IRc0ue+U85pbwxqebF6QQTw0DYafRvQz9gZ+ZI\/vfVLl\n 9btM5\/pij10u+Vh+v\/233IfcrnPZVE0\/g5DxTBQuS06FfEwUQ0rpX4KPV+Znj+Ei358lA9Mdboe\"             \/\/ Content of the Payload field from cmpi_lookup.\n}\n<\/pre>\n
Sample Response (failure)<\/strong><\/span><\/h5>\n
After payment request has been sent,\u00a0the expected failure response is similar to this if any.<\/p>\n
 {\n  \"errors\": [\n    {\n      \"code\": \"10409\",                                 \/\/ Error code.\n      \"message\": \"\\\"Payment already completed\\\"\"       \/\/ Error Message.\n    }\n  ],\n  \"transactionRef\": \"ESBDEV10003\"                      \/\/ Transaction unique identifier.\n}\n<\/pre>\n","protected":false},"author":1,"featured_media":0,"parent":2435,"menu_order":0,"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\/1335"}],"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\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=1335"}],"version-history":[{"count":4,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1335\/revisions"}],"predecessor-version":[{"id":3496,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/1335\/revisions\/3496"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/2435"}],"next":[{"title":"Authorize VISA\/Cardinal Transaction to Complete payment","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/interswitch-payment-gateway\/basic-purchase-visa-card\/authorize-visa-cardinal-transaction-to-complete-payment\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3497"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=1335"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=1335"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}