CHECKOUT GATEWAY DOCUMENTATION
\nThe checkout gateway allows merchant to receive payment in different currencies.
\nThere are different payment methods available to make payment and different apis to call. Payment methods include card, bank transfer, USSD, pay with bank account
\nThere are 3 major operations to perform so as to complete a payment. The api request body is passed as an encrypted data using the RSA encryption algorithm.
\nTo authorise the api request, public key (which is provided from the merchant dashboard) is required to be passed. on the header on all the requests.
\nThe 3 operations are
\nCreate Order
\nPay Order
\nVerify Payment Status
\nCreate order is the point where the customer details, the order details and every other information is been passed to create an order. which then returns the merchant information, the order details including the reference and the payment options available for the selected currency.
\nA unique reference is required to be passed which is used to identifier the order payment between the different systems involved.
\nThis is the point where the customer select the payment method they prefer to use either Card, USSD, Bank transfer or any other method available.
For Card payment different authorisation and authentication is used based on the card type.
After a payment has been made. the success response respond return from this endpoint does not guarantee the payment is successful because in some cases the customer would have to go through verification and validation process. This is where the 3rd operation comes in
\nThis is the point where the status of the payment can be confirmed. this endpoint can be called couple of times to get the update on a payment
\nPoint to Note
\nFor easy integration, an endpoint is provided only for staging (it is not available on production) to encrypt data to be send for each of this operations
\nSAMPLE ENCRYPTION CODE
\nimport rsa from 'node-forge'\nconst BigInteger = rsa.jsbn.BigInteger\nlet parser = new DOMParser()\nfunction encryptForge(data, rsa_pub_key) {\n let pk = rsa_pub_key\n let rsaKeyValue = atob(pk)\n rsaKeyValue = rsaKeyValue.split('!')[1]\n const xmlDoc = parser.parseFromString(rsaKeyValue, 'text/xml')\n const modulus = xmlDoc.getElementsByTagName('Modulus')[0].innerHTML\n const exponent = xmlDoc.getElementsByTagName('Exponent')[0].innerHTML\n const pubKey = rsa.pki.setRsaPublicKey(\n parseBigInteger(modulus),\n parseBigInteger(exponent),\n ) // e\n let encryptText = pubKey.encrypt(rsa.util.encodeUtf8(data))\n return btoa(encryptText)\n}\nfunction parseBigInteger(b64) {\n return new BigInteger(\n rsa.util.createBuffer(rsa.util.decode64(b64)).toHex(),\n 16,\n )\n}\nexport default encryptForge\n\nimport base64\nfrom Crypto.PublicKey import RSA\nfrom Crypto.Cipher import PKCS1_v1_5\nfrom Crypto.Util.Padding import pad\nimport xml.etree.ElementTree as ET\ndef encrypt(data, public_xml):\n try:\n if not data:\n raise Exception(\"Data sent for encryption is empty\")\n print(data)\n # Decode the Base64 string\n decoded_bytes = base64.b64decode(public_xml)\n # Convert the decoded bytes to a string\n decoded_string = decoded_bytes.decode('utf-8')\n public_xml_key = decoded_string.split('!')[1]\n modulus = getXmlComponent(public_xml_key, \"Modulus\")\n exponent = getXmlComponent(public_xml_key, \"Exponent\")\n modulus_bytes = base64.b64decode(modulus)\n exponent_bytes = base64.b64decode(exponent)\n # Create an RSA public key from Modulus and Exponent\n key = RSA.construct((int.from_bytes(modulus_bytes, byteorder='big'), int.from_bytes(exponent_bytes, byteorder='big')))\n # Initialize the Cipher for encryption\n cipher = PKCS1_v1_5.new(key)\n # Encrypt data\n encrypted_bytes = cipher.encrypt(bytes(data, 'utf-8'))\n print(encrypted_bytes)\n #Convert to base 64 string\n encrypted_bytes_ = base64.b64encode(encrypted_bytes)\n print(encrypted_bytes_)\n return encrypted_bytes\n except Exception as e:\n raise e\ndef getXmlComponent(xmlstring, _field):\n try:\n # Parse the XML string\n root = ET.fromstring(xmlstring)\n # Find elements with the specified field name\n modulusElements = root.findall(_field)\n modulusValue = \"\"\n if modulusElements:\n # Extract the Modulus value from the first element\n modulusValue = modulusElements[0].text\n print(\"Modulus Value:\", modulusValue)\n else:\n print(\"Modulus element not found.\")\n return modulusValue\n except Exception as e:\n # Handle exceptions (e.g., parsing errors)\n print(\"Error:\", str(e))\n return \"\"\n# Example usage:\n_data = \"{\\\"order\\\":{}}\"\npublic_xml = \"NDA5NiE8UlNBS2V5VmFsdWU+PE1vZHVsdXM+eTJTSXdvQTY4cmNwZlNYcjJwbWhUYmp3NzRLOEgwTW5CN2NhbWNSVStlMVZmZ3o3d2xISysvYi9kdE9NLzVtYVBZV1l0aW1YcURoNlppTHZyUytqaklhVkhjS2trS3dscTNrK1BTSDR1ckpqeElOQSt4RHBQSW1aWFVLMjJobmp2c2s1YTM2Vkx2Q1NPd2IwTXJXaHJwaXNKem9sS3VEaFR1MjhnYWNsT1FaR2JoNStNazdyV0ZnVjVLZThqcUFZK1FIMk16RmZYNys3ZldKbXhGQTlReEI5SThTODhBMC9SWm5SNUlJQWtrRHh3aGtsSlB0NEtQeG5GT0RmTHQyR3Z0YXp3NmlTNmNUUlBHVkF5MmNocDRrZmZSVFcrd0FhaTlycTV5V2h0cHFaOVlCZ1N1MUFLd2twd01NL3o0cVJHWDJOdWZoOEtnMWV6cUs0WkVnTGhOYnN1aXZ5NmdZNEZxMjdSZWpndDN1S0hmdmExaUtYLysxVVI5cmlIMjJYUVZEMzFIamFieUJoZ2lTcVBIMzgwUVBNMnlpdnpKZDdyWDZqMEpzZk1NRFlGejJzMCtIUHJoQmd6cFBua3l2S0RGMUFZcjRTc2RQaitCNUxrYlZESUg4TC9zZE1DcEpyblJqMWlHRXgvWUl4U1ExdEJFZWFnbWFxVVF2VVJYV2hOeHNIS0Nxa3Buelh3bVdpT3FUR1RNRWdpc2UvbkI3SHVuVlRITEZ0d0UyVE1LYXZxbEFkUHNxMytlSFNqUzhQVmZNK1IxL1VoMUVTR09aOFZZdThTMjdFYWl6dDY4SmhVbDQ0NnVjT0R4VEJTckFYS0ptdGhjZk9MZzNYekU5TVlkaEZiWisxRzlHbi91YkVFd2ZiZVZsOVViVXZ6WDEwZmxTZXRlUnZ0ZDg9PC9Nb2R1bHVzPjxFeHBvbmVudD5BUUFCPC9FeHBvbmVudD48L1JTQUtleVZhbHVlPg==\"\nencrypted_data = encrypt(_data, public_xml)\n\nimport org.w3c.dom.Document;\nimport org.w3c.dom.Element;\nimport org.w3c.dom.NodeList;\nimport org.xml.sax.SAXException;\nimport javax.crypto.Cipher;\nimport javax.xml.parsers.DocumentBuilder;\nimport javax.xml.parsers.DocumentBuilderFactory;\nimport javax.xml.parsers.ParserConfigurationException;\nimport java.io.File;\nimport java.io.FileOutputStream;\nimport java.io.IOException;\nimport java.io.UnsupportedEncodingException;\nimport java.nio.charset.StandardCharsets;\nimport java.security.*;\nimport java.security.spec.InvalidKeySpecException;\nimport java.security.spec.RSAPublicKeySpec;\nimport java.security.spec.X509EncodedKeySpec;\nimport java.util.Base64;\n//import javax.xml.bind.DatatypeConverter;\npublic class EncryptionHelper {\n private PrivateKey privateKey;\n private PublicKey publicKey;\n public static String getXmlComponent(String xmlstring, String _field) throws IOException, SAXException, ParserConfigurationException {\n // Create a DocumentBuilder\n DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance();\n DocumentBuilder dBuilder = dbFactory.newDocumentBuilder();\n // Parse the XML string\n Document doc = dBuilder.parse(new java.io.ByteArrayInputStream(xmlstring.getBytes(\"UTF-8\")));\n // Normalize the document\n doc.getDocumentElement().normalize();\n NodeList modulusNodeList = doc.getElementsByTagName(_field);\n String modulusValue = \"\";\n if (modulusNodeList.getLength() > 0) {\n Element modulusElement = (Element) modulusNodeList.item(0);\n // Extract the Modulus value\n modulusValue = modulusElement.getTextContent();\n System.out.println(\"Modulus Value: \" + modulusValue);\n } else {\n System.out.println(\"Modulus element not found.\");\n }\n return modulusValue;\n }\n public static byte[] encrypt(String _data, String publicXml) throws Exception {\n try {\n var data = _data.getBytes();\n if (data == null || data.length < 1) {\n throw new Exception(\"Data sent for encryption is empty\");\n }\n // Extract the Modulus and Exponent from the XML\n // Decode the Base64 string\n byte[] decodedBytes = Base64.getDecoder().decode(publicXml);\n // Convert the decoded bytes to a string\n String decodedString = new String(decodedBytes);\n var publicxmllkey = decodedString.split(\"!\")[1];\n System.out.println(publicxmllkey);\n var modulus = getXmlComponent(publicxmllkey, \"Modulus\");\n var exponent = getXmlComponent(publicxmllkey, \"Exponent\");\n String modulusBase64 = modulus;\n String exponentBase64 = exponent/* extract Exponent from publicXml */;\n // Convert the Base64-encoded Modulus and Exponent to byte arrays\n byte[] modulusBytes = Base64.getDecoder().decode(modulusBase64);\n byte[] exponentBytes =Base64.getDecoder().decode(exponentBase64);\n // Create RSAPublicKeySpec from Modulus and Exponent\n RSAPublicKeySpec keySpec = new RSAPublicKeySpec(\n new java.math.BigInteger(1, modulusBytes),\n new java.math.BigInteger(1, exponentBytes)\n );\n // Generate the PublicKey from the RSAPublicKeySpec\n KeyFactory keyFactory = KeyFactory.getInstance(\"RSA\");\n PublicKey publicKey = keyFactory.generatePublic(keySpec);\n // Initialize the Cipher for encryption\n Cipher cipher = Cipher.getInstance(\"RSA/ECB/PKCS1Padding\");\n cipher.init(Cipher.ENCRYPT_MODE, publicKey);\n // Encrypt the data\n byte[] encryptedBytes = cipher.doFinal(data);\n return encryptedBytes;\n } catch (Exception e) {\n throw e;\n }\n }\n public EncryptionHelper() throws Exception {\n var rowdata = \"Hello World\";\n var publicxml = \"NDA5NiE8UlNBS2V5VmFsdWU+PE1vZHVsdXM+eTJTSXdvQTY4cmNwZlNYcjJwbWhUYmp3NzRLOEgwTW5CN2NhbWNSVStlMVZmZ3o3d2xISysvYi9kdE9NLzVtYVBZV1l0aW1YcURoNlppTHZyUytqaklhVkhjS2trS3dscTNrK1BTSDR1ckpqeElOQSt4RHBQSW1aWFVLMjJobmp2c2s1YTM2Vkx2Q1NPd2IwTXJXaHJwaXNKem9sS3VEaFR1MjhnYWNsT1FaR2JoNStNazdyV0ZnVjVLZThqcUFZK1FIMk16RmZYNys3ZldKbXhGQTlReEI5SThTODhBMC9SWm5SNUlJQWtrRHh3aGtsSlB0NEtQeG5GT0RmTHQyR3Z0YXp3NmlTNmNUUlBHVkF5MmNocDRrZmZSVFcrd0FhaTlycTV5V2h0cHFaOVlCZ1N1MUFLd2twd01NL3o0cVJHWDJOdWZoOEtnMWV6cUs0WkVnTGhOYnN1aXZ5NmdZNEZxMjdSZWpndDN1S0hmdmExaUtYLysxVVI5cmlIMjJYUVZEMzFIamFieUJoZ2lTcVBIMzgwUVBNMnlpdnpKZDdyWDZqMEpzZk1NRFlGejJzMCtIUHJoQmd6cFBua3l2S0RGMUFZcjRTc2RQaitCNUxrYlZESUg4TC9zZE1DcEpyblJqMWlHRXgvWUl4U1ExdEJFZWFnbWFxVVF2VVJYV2hOeHNIS0Nxa3Buelh3bVdpT3FUR1RNRWdpc2UvbkI3SHVuVlRITEZ0d0UyVE1LYXZxbEFkUHNxMytlSFNqUzhQVmZNK1IxL1VoMUVTR09aOFZZdThTMjdFYWl6dDY4SmhVbDQ0NnVjT0R4VEJTckFYS0ptdGhjZk9MZzNYekU5TVlkaEZiWisxRzlHbi91YkVFd2ZiZVZsOVViVXZ6WDEwZmxTZXRlUnZ0ZDg9PC9Nb2R1bHVzPjxFeHBvbmVudD5BUUFCPC9FeHBvbmVudD48L1JTQUtleVZhbHVlPg==\";\n var result = encrypt(rowdata, publicxml);\n // Encode the byte array to a Base64 string\n String base64String = Base64.getEncoder().encodeToString(result);\n System.out.println(\"Converted successfully\");\n System.out.println(base64String);\n }\n public static void main(String[] args) throws Exception {\n EncryptionHelper keyPairGenerator = new EncryptionHelper();\n }\n}\n\nrequire 'vendor/autoload.php';\nuse phpseclib3\\Crypt\\RSA;\nuse phpseclib3\\Math\\BigInteger;\nfunction getXmlComponent($xmlstring, $field)\n{\n try {\n // Load XML\n $xml = new SimpleXMLElement($xmlstring);\n // Register namespaces if any\n $namespaces = $xml->getNamespaces(true);\n foreach ($namespaces as $prefix => $namespace) {\n if ($prefix === '') {\n $prefix = 'default';\n }\n $xml->registerXPathNamespace($prefix, $namespace);\n }\n // Construct the correct XPath query\n $result = null;\n if (!empty($namespaces)) {\n foreach ($namespaces as $prefix => $namespace) {\n $prefix = $prefix ?: 'default';\n $result = $xml->xpath(\"//$prefix:$field\");\n if ($result) {\n break;\n }\n }\n } else {\n $result = $xml->xpath(\"//$field\");\n }\n // Check if the element was found\n if ($result && count($result) > 0) {\n return (string)$result[0];\n } else {\n echo \"Element $field not found.\\n\";\n return \"\";\n }\n } catch (Exception $e) {\n echo \"Error: \" . $e->getMessage() . \"\\n\";\n return \"\";\n }\n}\nfunction encryptData($data, $public_xml)\n{\n try {\n if (!$data) {\n throw new Exception(\"Data sent for encryption is empty\");\n }\n // Decode the Base64 string\n $decoded_bytes = base64_decode($public_xml);\n $decoded_string = mb_convert_encoding($decoded_bytes, 'UTF-8');\n $public_xml_key = explode('!', $decoded_string)[1];\n echo $public_xml_key;\n $modulus = getXmlComponent($public_xml_key, \"Modulus\");\n $exponent = getXmlComponent($public_xml_key, \"Exponent\");\n $modulus_bytes = base64_decode($modulus);\n $exponent_bytes = base64_decode($exponent);\n // Create an RSA public key from Modulus and Exponent\n $rsa = RSA::loadFormat('raw', [\n 'n' => new BigInteger($modulus_bytes, 256),\n 'e' => new BigInteger($exponent_bytes, 256)\n ]);\n echo \"Trying to encrypt data\" . \"\\n\";\n // Encrypt data\n $rsa = $rsa->withPadding(RSA::ENCRYPTION_PKCS1);\n $encrypted = $rsa->encrypt($data);\n // Convert to base 64 string\n $encrypted_base64 = base64_encode($encrypted);\n echo \"base 64 value\" . \"\\n\";\n echo $encrypted_base64 . \"\\n\";\n return $encrypted_base64;\n } catch (Exception $e) {\n echo \"Error: \" . $e->getMessage() . \"\\n\";\n return \"No encrypted ata\";\n }\n}\n// Example usage\n$data = \"{\\r\\n \\\"customer\\\": {\\r\\n \\\"firstname\\\": \\\"firstname\\\",\\r\\n \\\"lastname\\\": \\\"lastname\\\",\\r\\n \\\"mobile\\\": \\\"+2348158200000\\\",\\r\\n \\\"country\\\": \\\"NG\\\",\\r\\n \\\"email\\\": \\\"email@pay.dev\\\"\\r\\n },\\r\\n \\\"order\\\": {\\r\\n \\\"amount\\\": 3,\\r\\n \n\\\"reference\\\": \\\"223232323121212122121QWW2QWWW\\\",\\r\\n \\\"description\\\": \\\"Pay\\\",\\r\\n \\\"currency\\\": \\\"USD\\\"\\r\\n },\\r\\n \\\"payment\\\": {\\r\\n \\\"RedirectUrl\\\": \\\"https://www.hi.com\\\"\\r\\n }\\r\\n}\";\n$public_xml = \"NDA5NiE8UlNBS2V5VmFsdWU+PE1vZHVsdXM+eStWT0Q0Ymp2bnZ5Wmh6eW9ySDRNMDlpRGlGeXFwTlRGYVV6WU9ER3lFaXNqRFBkdEVCdjJvbzNyTm1vMkt6TmJTSGl1MzdmeDhKdWN3bHRIUHUrank0bUFSNGp5N0ZiOURkT2x3blpVaDVUMnlXSUU2OExhL3hGTFJQUTN3TmpkNER0RStpbkM0YStHQ1hQR0FTVm5XS3MrM1hQcEpiS1FFVHZxYUluVUZ0RVZQaGtabGtWNXpNRWU0eVVDNzZDSGxxR0hWMWJobXNEdS9GKzVEVHMvY1REd2NOSStXN1RHUjZuRmhnUFkrQU9vV3R2QzRobVBYc1VhR3NjVjNkbkV6Q0lDUTMxZHQwZ0NYdVdqN21LZ1dyT3N2a2IvaUp6RkVpRzdRL1hqaENiTzRRWENZcEF2eEpWSGkrQWV2WlYxTDQrRW9vZWVLU3N0REoxYlF2WW00L1NnQmszN0FZQXNEUElRZFUzaGsrbFdSWjhXeWRhZ2RlV3FHbVUybEt2Y1Z6MDMzVk1RMlZzS2x0NmFldG01Rmtsc3FpeFJPWUpxZHBMUU1BZldQVGxVLytQUUxMWHFEbUxOZ3ZFWm5PUEFjeE1EbEg2dEh0RVhvLysxQ1RmNzdEaDhPTGpmcGgvWTBCU3pjRndDODE0NUlld0hBSW9ZTTFLeUNvdElFazVyQXVxZks2aHpEWS9CUnN6VkNLYTVNNTVXRDJzclJ6dFVtNHNlaUNoVzlZVlV6ZUg1MFV3RmN3b1pLTlN5UEhYMXJocE54eTZkV2JXWVNuMjQwZTVwWEFQWFgyNUEwRElWK1RUMjcxNnRPQ2pxanpaMENZbXpkZ3ozYmVlQi8yQzRKV2lsZlNxejYyY3llWDVFem5PdE9rNkRNWEZrY2xPMzhMNVU4RTIwZlU9PC9Nb2R1bHVzPjxFeHBvbmVudD5BUUFCPC9FeHBvbmVudD48L1JTQUtleVZhbHVlPg==\";\n$encrypted_data = encryptData($data, $public_xml);\necho \"Encrypted data\" . \"\\n\";\necho $encrypted_data . \"\\n\";\n\nPay Order
\nAfter completing the pay order request.
\nIt's important to keep pulling the order status/verify endpoint to know when the status of the order has changed and customer can be notified properly of successful payment. If the status of the order didn't change after about 5 minutes then the status of the order can be on pending and customer would be notified once the transaction has been completed
\n","_postman_id":"bf2c0d25-a9e3-4062-a06b-35ab04a6a0ed"},{"name":"Get Order Status","item":[{"name":"Sample Payload to encrypt","event":[{"listen":"test","script":{"id":"87062bdc-dd20-4bbd-b1e6-caadba10fa66","exec":["if(pm.response.code == 200){"," pm.collectionVariables.set('encrypteddata', pm.response.json().data);","}"],"type":"text/javascript","packages":{}}}],"id":"ef342d40-c84e-49aa-8a1e-6bf6c53d669e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"{{yourreference}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/data/encrypt","urlObject":{"path":["charge","data","encrypt"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[{"id":"2037b9aa-ac1c-40aa-94f1-4d8c86962b6c","name":"Encrypt Order Status payload","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"{{yourreference}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/payment/data/encrypt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 31 Mar 2024 14:09:29 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"Kestrel"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": \"ASK7UxU45861CgMkQGlcUbQgLcWBpuw4sUEnd4+xWfD5VnEK6rT07cBb32VLcHK910Hpf3K+RD5n4JSwZC6Eu0PvBLAIPjH8FCkGATyo9+C2IS8OcNGLB4cHYNIfdUAUUmDFXqXMW5uz7gmJdfH47TyTmIbEh7ErJyGnM/vDdIUHJD0eh/m/xr1xdCXIUITQyIQ9ABu6MH4W8vjFg3MaW2iJC6wJVoKejd5HomJtUiGBOrlri1tUx0xuQs3rS0/Z2qxEed0j6aZHy1wfifHY6p4WOok7umx4FTTU1In3xS8Fwh2GB4YZizFVAtrghioL2IiXNauTgV+hKk9X56Ti3A7+VOm7ytPduysitaDWL6ZxNEEyepy83amFOGBIYySUGNrltCkUx2sSezH8Zdwv9IqlFoplo5zViSqyAjUB8BP86H0YF+Toc9s9c/XjVK+w811ypVVcVlKJL6I86usKwvDgZqR8s2ExUAJBvNZFSJ+RZE9Y3JBzUm2iKPTffGO90rVX30GsGZmTVwsVw/FPPP9iUOKxFXWplXmS/5mL5R0XTh3DL3gte8FyLjMkf9BPcCiCJ6L5910Iolb2PDC/jVBqoMVRRuMO30Qgy1UuFFQ6XmHEyzXh7WUPd12l00vi3s6AOp7+J6ZMzWp42AD75K7iQ9T5GkTj0tBBmpVGrMI=\",\n \"message\": \"Operation successful\"\n}"}],"_postman_id":"ef342d40-c84e-49aa-8a1e-6bf6c53d669e"},{"name":"Order status Api Request","id":"eea2802d-b89e-472c-8c57-daf65c997fc5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"data\": \"{{encrypteddata}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/status","urlObject":{"path":["charge","order","status"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[{"id":"753b8971-06dc-4849-8150-fdca75ed061f","name":"Order status Api Request","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"data\": \"{{encrypteddata}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"1441"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 04 Oct 2024 20:03:45 GMT"},{"key":"Server","value":"Kestrel"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"Successful\",\n \"statusCode\": \"00\",\n \"message\": \"Transaction was completed successfully\",\n \"data\": {\n \"isFinalStatus\": true,\n \"requeryNeeded\": false,\n \"requeryType\": null,\n \"orderSummary\": {\n \"id\": 2,\n \"paymentReference\": \"IDPAY-44881C80828A11EFA2D8022E6061EEF7\",\n \"orderReference\": \"856772289\",\n \"totalChargedAmount\": 10.6,\n \"fee\": 0.6,\n \"statusId\": 5,\n \"status\": \"Successful\",\n \"paymentType\": \"C\",\n \"currencyId\": 6,\n \"paymentResponseCode\": \"00\",\n \"paymentResponseMessage\": \"Transaction was completed successfully\",\n \"providerResponseDate\": null,\n \"datePaymentConfirmed\": null,\n \"dateCreated\": \"2024-10-04T19:53:03\",\n \"narration\": \"Pay\",\n \"remarks\": \"Order initiated and created successfully\"\n },\n \"orderPayments\": [\n {\n \"orderId\": 2,\n \"orderPaymentReference\": \"BLZPGW-PAYREF-878E58BF2D764D1EB7ADC0878944FD46\",\n \"paymentOptionId\": 2,\n \"statusId\": 5,\n \"orderPaymentResponseCode\": \"00\",\n \"orderPaymentResponseMessage\": \"Transaction was completed successfully\",\n \"orderPaymentInstrument\": null,\n \"remarks\": \"Order payment initiated\",\n \"providerReference\": \"CP6A39208B-F834-4A7A-93CA-2101D870D049\",\n \"providerResponseCode\": \"02\",\n \"paymentUrl\": \"https://core-api-service.payment.blaaiz.com/web/card/authorize/CP6A39208B-F834-4A7A-93CA-2101D870D049/initiate\",\n \"externalReference\": \"40878740125146805\",\n \"authOption\": null,\n \"saveCard\": null,\n \"processorProviderBank\": \"FCMB\",\n \"order\": null,\n \"id\": 2,\n \"dateCreated\": \"2024-10-04T20:02:07.144019\",\n \"dateUpdated\": \"2024-10-04T20:02:25.548306\",\n \"dateDeleted\": null,\n \"createdBy\": -1,\n \"updatedBy\": -1,\n \"deletedBy\": null\n }\n ]\n }\n}"}],"_postman_id":"eea2802d-b89e-472c-8c57-daf65c997fc5"}],"id":"dd804ab0-f305-4eed-800d-9c76cb4f3f1e","_postman_id":"dd804ab0-f305-4eed-800d-9c76cb4f3f1e","description":""},{"name":"Save Card After Charge","item":[{"name":"Sample Payload to encrypt","event":[{"listen":"test","script":{"id":"87062bdc-dd20-4bbd-b1e6-caadba10fa66","exec":["if(pm.response.code == 200){"," pm.collectionVariables.set('encrypteddata', pm.response.json().data);","}"],"type":"text/javascript","packages":{}}}],"id":"fac871fd-b71e-410f-8ff3-8d738b70ea9c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"{{yourreference}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/data/encrypt","urlObject":{"path":["charge","data","encrypt"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[{"id":"8bd50065-b604-4012-8f32-c2cb668768cb","name":"Encrypt Order Status payload","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"{{yourreference}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/payment/data/encrypt"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 31 Mar 2024 14:09:29 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"Kestrel"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": \"ASK7UxU45861CgMkQGlcUbQgLcWBpuw4sUEnd4+xWfD5VnEK6rT07cBb32VLcHK910Hpf3K+RD5n4JSwZC6Eu0PvBLAIPjH8FCkGATyo9+C2IS8OcNGLB4cHYNIfdUAUUmDFXqXMW5uz7gmJdfH47TyTmIbEh7ErJyGnM/vDdIUHJD0eh/m/xr1xdCXIUITQyIQ9ABu6MH4W8vjFg3MaW2iJC6wJVoKejd5HomJtUiGBOrlri1tUx0xuQs3rS0/Z2qxEed0j6aZHy1wfifHY6p4WOok7umx4FTTU1In3xS8Fwh2GB4YZizFVAtrghioL2IiXNauTgV+hKk9X56Ti3A7+VOm7ytPduysitaDWL6ZxNEEyepy83amFOGBIYySUGNrltCkUx2sSezH8Zdwv9IqlFoplo5zViSqyAjUB8BP86H0YF+Toc9s9c/XjVK+w811ypVVcVlKJL6I86usKwvDgZqR8s2ExUAJBvNZFSJ+RZE9Y3JBzUm2iKPTffGO90rVX30GsGZmTVwsVw/FPPP9iUOKxFXWplXmS/5mL5R0XTh3DL3gte8FyLjMkf9BPcCiCJ6L5910Iolb2PDC/jVBqoMVRRuMO30Qgy1UuFFQ6XmHEyzXh7WUPd12l00vi3s6AOp7+J6ZMzWp42AD75K7iQ9T5GkTj0tBBmpVGrMI=\",\n \"message\": \"Operation successful\"\n}"}],"_postman_id":"fac871fd-b71e-410f-8ff3-8d738b70ea9c"},{"name":"Save Card Api Request","id":"dac6dae6-2a67-4e77-bc44-a438107375f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078"}],"body":{"mode":"raw","raw":"{\r\n \"data\": \"{{encrypteddata}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/save-card","urlObject":{"path":["charge","order","save-card"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"dac6dae6-2a67-4e77-bc44-a438107375f6"}],"id":"90449c08-4888-4715-8e19-65b7b6228b81","_postman_id":"90449c08-4888-4715-8e19-65b7b6228b81","description":""},{"name":"Get Order Fee","item":[{"name":"Sample Encrypt Order fee","event":[{"listen":"test","script":{"id":"8691c2d5-28be-4694-b20d-3e3859c481b5","exec":["if(pm.response.code == 200){"," pm.collectionVariables.set('encrypteddata', pm.response.json().data);","}"],"type":"text/javascript","packages":{}}}],"id":"1f03c313-3c31-4f23-b433-7673ecd24e47","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"amount\": 100,\r\n \"paymentoption\": \"C\",\r\n \"currency\": \"USD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/data/encrypt","urlObject":{"path":["charge","data","encrypt"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"1f03c313-3c31-4f23-b433-7673ecd24e47"},{"name":"Get fee Api Request","id":"e3c4b591-57de-4b28-a136-18b87f1bb2df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"data\": \"{{encrypteddata}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/fee","urlObject":{"path":["charge","order","fee"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e3c4b591-57de-4b28-a136-18b87f1bb2df"}],"id":"7ae90c2b-b42e-449f-b4d0-9dd076e3430f","_postman_id":"7ae90c2b-b42e-449f-b4d0-9dd076e3430f","description":""},{"name":"Track event","item":[{"name":"Sample Encrypt Payload","event":[{"listen":"test","script":{"id":"837e086f-69c3-47be-8fa2-ad432751c8a3","exec":["if(pm.response.code == 200){"," pm.collectionVariables.set('encrypteddata', pm.response.json().data);","}"],"type":"text/javascript","packages":{}}}],"id":"8321ee68-f10c-4af8-ba40-eb3a7936a1e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"eventname\": \"CARD-ENTERED\",\r\n \"orderreference\": {{yourreference}},\r\n \"meta\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/data/encrypt","urlObject":{"path":["charge","data","encrypt"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8321ee68-f10c-4af8-ba40-eb3a7936a1e2"},{"name":"Track event Api request","id":"11042d12-5fd2-443a-9f65-d4f2af9bf0bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-PUBLICKEY-TEST-0636514C752748D7B16D35D8EF870078","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"Data\":\"{{encrypteddata}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/event/track","urlObject":{"path":["charge","order","event","track"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"11042d12-5fd2-443a-9f65-d4f2af9bf0bd"}],"id":"0765dd66-427c-45a1-b5e9-cd37cf82bc71","_postman_id":"0765dd66-427c-45a1-b5e9-cd37cf82bc71","description":""},{"name":"Banks","item":[{"name":"Get All banks","id":"1e6414cc-bf40-4469-81a0-7f4f8625d08e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/banks","urlObject":{"path":["charge","banks"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[{"disabled":true,"key":"paymentmethod","value":"ussd"}],"variable":[]}},"response":[],"_postman_id":"1e6414cc-bf40-4469-81a0-7f4f8625d08e"},{"name":"Get Banks for USSD","id":"4b399570-0df8-44c3-bd67-1b68a9ac9316","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/banks?paymentmethod=ussd","urlObject":{"path":["charge","banks"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[{"key":"paymentmethod","value":"ussd"}],"variable":[]}},"response":[],"_postman_id":"4b399570-0df8-44c3-bd67-1b68a9ac9316"},{"name":"Get Banks for Bank transfer","id":"b7f6831c-e37f-43e0-9b84-dbed745ee89f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/banks?paymentmethod=ussd","urlObject":{"path":["charge","banks"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[{"key":"paymentmethod","value":"ussd"}],"variable":[]}},"response":[],"_postman_id":"b7f6831c-e37f-43e0-9b84-dbed745ee89f"}],"id":"8be4fb50-ab78-44d1-994c-d2fc35b2cab3","_postman_id":"8be4fb50-ab78-44d1-994c-d2fc35b2cab3","description":""},{"name":"Payment links","item":[{"name":"Fetch Payment link","event":[{"listen":"prerequest","script":{"id":"c8bac655-4ba0-41d3-b804-26fcf2070102","exec":["pm.environment.set('reference','DWErSBFXJW51b#xTY_8yFJDmg2JT#zVuJxYQMkHwE1ze124')"],"type":"text/javascript","packages":{}}}],"id":"de09916d-2f12-4126-b2b6-d01f9b3cae07","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/paymentlink/info?reference=rferfefhfhfhfh","urlObject":{"path":["charge","paymentlink","info"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[{"key":"reference","value":"rferfefhfhfhfh"}],"variable":[]}},"response":[],"_postman_id":"de09916d-2f12-4126-b2b6-d01f9b3cae07"},{"name":"Get Payment Keys","id":"c70bfc04-3f1f-4409-9201-c2be2db56771","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"reference\":\"vGKillnWfoEajA5mUXe8qoDGAIn9xv8Y4xbO4O8Us4PIPbM6hRq36\"\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/paymentlink/get-keys","urlObject":{"path":["charge","paymentlink","get-keys"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c70bfc04-3f1f-4409-9201-c2be2db56771"}],"id":"2b81b3c7-957a-4656-85b1-36f28de8ea3e","_postman_id":"2b81b3c7-957a-4656-85b1-36f28de8ea3e","description":""},{"name":"Tokenize Charge with Seck key","item":[{"name":"Tokenize Charge","event":[{"listen":"prerequest","script":{"id":"1a5f5a30-e357-4590-891c-f67e4650e3b0","exec":[" pm.collectionVariables.set('reference', Math.floor(Math.random() * 1000000000));"],"type":"text/javascript","packages":{}}}],"id":"8006a7e4-6ef0-4415-96af-a28d34d2383f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-SECRETKEY-TEST-E3BA14FBDF684B7D85AF12B901B715F5"}],"body":{"mode":"raw","raw":"{\r\n \"customer\": {\r\n \"firstname\": \"testtoken\",\r\n \"lastname\": \"pay\",\r\n \"mobile\": \"+23481582333444\",\r\n \"country\": \"NG\",\r\n \"email\": \"etokenmail@test.com\"\r\n },\r\n \"order\": {\r\n \"amount\": 2,\r\n \"reference\": \"{{yourreference}}\",\r\n \"description\": \"Pay\",\r\n \"currency\": \"NGN\"\r\n },\r\n \"payment\": {\r\n \"RedirectUrl\": \"https://www.hi.com\"\r\n },\r\n \"authorization\": {\r\n \"cardToken\": \"TKNMDU4MzU4NzUwNTk0Mjg5NzQwMzgwNDA0NzQ1ODkz2173\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/card/tokenized/pay","urlObject":{"path":["charge","order","card","tokenized","pay"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8006a7e4-6ef0-4415-96af-a28d34d2383f"}],"id":"01bd0fe5-4c15-4d4f-966d-970720a2cc58","_postman_id":"01bd0fe5-4c15-4d4f-966d-970720a2cc58","description":""},{"name":"Verify Order with Sec Key","item":[{"name":"verify status","id":"8881dcb3-222b-4cbc-b5a5-a03a7631f020","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-SECRETKEY-TEST-E3BA14FBDF684B7D85AF12B901B715F5"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"{{yourreference}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/verify","urlObject":{"path":["charge","order","verify"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8881dcb3-222b-4cbc-b5a5-a03a7631f020"}],"id":"e70014fb-a406-4509-98bc-71092715a478","_postman_id":"e70014fb-a406-4509-98bc-71092715a478","description":""},{"name":"Refund Order with Sec Key","item":[{"name":"Refund order","id":"6431389b-c495-456f-9760-443aad4ffa5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"BLZPGW-SECRETKEY-TEST-E3BA14FBDF684B7D85AF12B901B715F5"}],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"{{yourreference}}\",\r\n \"reason\": \"\", // reason for refund\r\n \"amount\": \"\" // optional\r\n}","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/refund","urlObject":{"path":["charge","order","refund"],"host":["https://checkout-api-service.payment.blaaiz.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6431389b-c495-456f-9760-443aad4ffa5d"},{"name":"Get refunds","id":"0dd79f90-b9a0-4708-924d-635c18c21a95","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"api-key","value":"BLZPGW-SECRETKEY-TEST-E3BA14FBDF684B7D85AF12B901B715F5"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://checkout-api-service.payment.blaaiz.com/charge/order/refunds/all?Id=