{"type":"doc","content":[{"type":"paragraph","content":[{"text":"As a Moniepoint-powered business, your Enterprise resource planning (ERP) system can send purchase transaction details to Moniepoint POS terminals for payment processing. This feature will help streamline your sales process and make it easier for your customers to make payments for purchases. You can accept payments using debit cards by integrating your ERP software (like Retailman) with Moniepoint POS terminals via Serial Port.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get started with your integration","type":"text"}]},{"type":"paragraph","content":[{"text":"Prerequisites","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Here are the tools you need before starting.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Moniepoint POS terminal (supported app version is 1.7.0 or higher)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable ERP integration under your Moniepoint account settings. Navigate to POS terminal configuration > POS Terminal features to enable this feature.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Point of sale (POS) system with a serial port interface or a personal computer loaded with the ERP software.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data cable (USB cable or type C to RS-232 serial cable).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Establishing a Connection Using the Serial Port Communications Protocol","type":"text"}]},{"type":"paragraph","content":[{"text":"Highlighted below are instructions for establishing a connection between the payment terminal and an ERP system using the serial port communications protocol. ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"How it works","type":"text"}]},{"type":"paragraph","content":[{"text":"The ERP system needs to be configured to communicate with the POS terminal using the serial port. This typically involves establishing a connection between the two devices using a serial communication protocol. Once the connection has been established, the ERP system can send the transaction details to the POS terminal over the serial port. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The transaction details include the following: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"amount","type":"text","marks":[{"type":"strong"}]},{"text":" of the purchase,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"transaction reference","type":"text","marks":[{"type":"strong"}]},{"text":" and,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the ","type":"text"},{"text":"transaction type","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The POS terminal processes the payment using the transaction details and returns a response indicating the transaction’s outcome to the ERP system. The ERP system can complete the sale and update any necessary records or databases.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Setting up","type":"text"}]},{"type":"paragraph","content":[{"text":"Step one: Connect the serial cable","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect the serial cable to the serial port of your POS system and the other end to your Moniepoint POS terminal.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Step two: Verify Serial Port Connection","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Windows:","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to Device manager ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Ports (COM & LPT) ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that you can detect the specific COM Port, e.g. (COM 1, COM 2)","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Mac or Linux:","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On your terminal, run the command below","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"$>","type":"text","marks":[{"type":"em"}]},{"text":" ls /dev/tty.*","type":"text"}]},{"type":"paragraph","content":[{"text":"Step three: Configure connection on ERP software","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Configure communication with the terminal based on the ERP software you are using. Once the connection is verified, you can test with the Moniepoint POS Terminal. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Communication between Moniepoint POS terminal and ERP system","type":"text"}]},{"type":"paragraph","content":[{"text":"The diagram describes the communication flow between the ERP system and Moniepoint POS terminal.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1302,"id":"af51cc3d-bffc-482f-887d-ab898abd625c","collection":"contentId-993067027","type":"file","height":1324}}]},{"type":"paragraph","content":[{"text":"Fig 1. Diagram showing communication flow between Moniepoint POS terminal and client ERP system","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Payment request configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Step one: Test the connection","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" All characters presented are ASCII characters. Refer to this ","type":"text"},{"text":"documentation","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://www.eso.org/~ndelmott/ascii.html"}}]},{"text":" for the specific Decimal code to send.","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample Response ","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have any issues establishing connection, verify the serial cable is properly connected and the request was sent in the correct format.","type":"text"}]},{"type":"paragraph","content":[{"text":"Step two: Send payment request","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"On receiving the response (in step one), proceed to send the payment request in XML format. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample Request ","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n\n \n\n 1\n 900.70\n 123494911108\n\n\n\n\n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"TransactionType:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"1 – Credit Card Purchase","type":"text"},{"type":"hardBreak"},{"text":"2 – Debit Card Purchase","type":"text"},{"type":"hardBreak"},{"text":"3 – Debit / Credit Cash Out","type":"text"},{"type":"hardBreak"},{"text":"4 – Debit / Credit Card Void","type":"text"},{"type":"hardBreak"},{"text":"5 – Credit Card Return","type":"text"},{"type":"hardBreak"},{"text":"6 – Debit Card Return","type":"text"},{"type":"hardBreak"},{"text":"7 – Credit / Debit Card Balance ","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":" \n\n512345******1230\n00\n1B7D\nCUSTOMER/ZENITH\n10000\n000000000007\n\n2023-09-11T17:07:33.000000000\nCARD_PURCHASE\nMASTERCARD\n","type":"text"}]},{"type":"paragraph","content":[{"text":"ResponseCode:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"00 - Approved or completed successfully ","type":"text"}]},{"type":"paragraph","content":[{"text":"01 - Refer to card issuer","type":"text"}]},{"type":"paragraph","content":[{"text":"02 - Refer to card issuer, special condition ","type":"text"}]},{"type":"paragraph","content":[{"text":"03 - Invalid merchant","type":"text"}]},{"type":"paragraph","content":[{"text":"04 - Pick-up card","type":"text"}]},{"type":"paragraph","content":[{"text":"05 - Do not honour","type":"text"}]},{"type":"paragraph","content":[{"text":"06 - Error","type":"text"}]},{"type":"paragraph","content":[{"text":"07 - Pick-up card, special condition ","type":"text"}]},{"type":"paragraph","content":[{"text":"08 - Honor with identification","type":"text"}]},{"type":"paragraph","content":[{"text":"09 - Request in progress","type":"text"}]},{"type":"paragraph","content":[{"text":"10 - Approved, partial","type":"text"}]},{"type":"paragraph","content":[{"text":"11 - Approved, VIP","type":"text"}]},{"type":"paragraph","content":[{"text":"12 - Invalid transaction","type":"text"}]},{"type":"paragraph","content":[{"text":"13 - Invalid amount","type":"text"}]},{"type":"paragraph","content":[{"text":"14 - Invalid card number","type":"text"}]},{"type":"paragraph","content":[{"text":"15 - No such issuer","type":"text"}]},{"type":"paragraph","content":[{"text":"16 - Approved, update track 3","type":"text"}]},{"type":"paragraph","content":[{"text":"17 - Customer cancellation","type":"text"}]},{"type":"paragraph","content":[{"text":"18 - Customer dispute","type":"text"}]},{"type":"paragraph","content":[{"text":"19 - Re-enter transaction","type":"text"}]},{"type":"paragraph","content":[{"text":"20 - Invalid response","type":"text"}]},{"type":"paragraph","content":[{"text":"21 - No action taken","type":"text"}]},{"type":"paragraph","content":[{"text":"22 - Suspected malfunction","type":"text"}]},{"type":"paragraph","content":[{"text":"23 - Unacceptable transaction fee ","type":"text"}]},{"type":"paragraph","content":[{"text":"24 - File update not supported","type":"text"}]},{"type":"paragraph","content":[{"text":"25 - Unable to locate record","type":"text"}]},{"type":"paragraph","content":[{"text":"26 - Duplicate record","type":"text"}]},{"type":"paragraph","content":[{"text":"27 - File update edit error","type":"text"}]},{"type":"paragraph","content":[{"text":"28 - File update file locked","type":"text"}]},{"type":"paragraph","content":[{"text":"29 - File update failed","type":"text"}]},{"type":"paragraph","content":[{"text":"30 - Format error","type":"text"}]},{"type":"paragraph","content":[{"text":"31 - Bank not supported","type":"text"}]},{"type":"paragraph","content":[{"text":"32 - Completed partially","type":"text"}]},{"type":"paragraph","content":[{"text":"33 - Expired card, pick-up","type":"text"}]},{"type":"paragraph","content":[{"text":"34 - Suspected fraud, pick-up","type":"text"}]},{"type":"paragraph","content":[{"text":"35 - Contact acquirer, pick-up","type":"text"}]},{"type":"paragraph","content":[{"text":"36 - Restricted card, pick-up","type":"text"}]},{"type":"paragraph","content":[{"text":"37 - Call acquirer security, pick-up ","type":"text"}]},{"type":"paragraph","content":[{"text":"38 - PIN tries exceeded, pick-up","type":"text"}]},{"type":"paragraph","content":[{"text":"39 - No credit account","type":"text"}]},{"type":"paragraph","content":[{"text":"40 - Function not supported","type":"text"}]},{"type":"paragraph","content":[{"text":"41 - Lost card","type":"text"}]},{"type":"paragraph","content":[{"text":"42 - No universal account","type":"text"}]},{"type":"paragraph","content":[{"text":"43 - Stolen card","type":"text"}]},{"type":"paragraph","content":[{"text":"44 - No investment account","type":"text"}]},{"type":"paragraph","content":[{"text":"51 - Not sufficient funds","type":"text"}]},{"type":"paragraph","content":[{"text":"52 - No check account","type":"text"}]},{"type":"paragraph","content":[{"text":"53 - No savings account","type":"text"}]},{"type":"paragraph","content":[{"text":"54 - Expired card","type":"text"}]},{"type":"paragraph","content":[{"text":"55 - Incorrect PIN","type":"text"}]},{"type":"paragraph","content":[{"text":"56 - No card record","type":"text"}]},{"type":"paragraph","content":[{"text":"57 - Transaction not permitted to cardholder","type":"text"}]},{"type":"paragraph","content":[{"text":"58 - Transaction not permitted on terminal","type":"text"}]},{"type":"paragraph","content":[{"text":"59 - Suspected fraud","type":"text"}]},{"type":"paragraph","content":[{"text":"60 - Contact acquirer","type":"text"}]},{"type":"paragraph","content":[{"text":"61 - Exceeds withdrawal limit","type":"text"}]},{"type":"paragraph","content":[{"text":"62 - Restricted card","type":"text"}]},{"type":"paragraph","content":[{"text":"63 - Security violation","type":"text"}]},{"type":"paragraph","content":[{"text":"64 - Original amount incorrect","type":"text"}]},{"type":"paragraph","content":[{"text":"65 - Exceeds withdrawal frequency","type":"text"}]},{"type":"paragraph","content":[{"text":"66 - Call acquirer security","type":"text"}]},{"type":"paragraph","content":[{"text":"67 - Hard capture","type":"text"}]},{"type":"paragraph","content":[{"text":"68 - Response received too late","type":"text"}]},{"type":"paragraph","content":[{"text":"75 - PIN tries exceeded","type":"text"}]},{"type":"paragraph","content":[{"text":"77 - Intervene, bank approval required","type":"text"}]},{"type":"paragraph","content":[{"text":"78 - Intervene, bank approval required for partial amount ","type":"text"}]},{"type":"paragraph","content":[{"text":"90 - Cut-off in progress","type":"text"}]},{"type":"paragraph","content":[{"text":"91 - Issuer or switch inoperative","type":"text"}]},{"type":"paragraph","content":[{"text":"92 - Routing error","type":"text"}]},{"type":"paragraph","content":[{"text":"93 - Violation of law","type":"text"}]},{"type":"paragraph","content":[{"text":"94 - Duplicate transaction","type":"text"}]},{"type":"paragraph","content":[{"text":"95 - Reconcile error","type":"text"}]},{"type":"paragraph","content":[{"text":"96 - System malfunction","type":"text"}]},{"type":"paragraph","content":[{"text":"98 - Exceeds cash limit","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Communication library","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"link","type":"text","marks":[{"type":"link","attrs":{"href":"https://teamapt.atlassian.net/wiki/x/GADzPw"}}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":" Contact Support:","type":"text"}]},{"type":"paragraph","content":[{"text":"pos-integrations@moniepoint.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:pos-integrations@moniepoint.com"}}]}]}],"version":1}

Browser not supported