POS Integration (USB)

This integration enables your system to interact with OPay POS via a USB data cable. It streamlines the payment collection process to eliminate human errors, reduce the turnaround time, and ensure a smooth reconciliation experience by synchronizing payment results in real-time.

Preparation

1 Step 1: Make sure you update the POS app to version 3.4.4 or above.

preparation1 preparation2 preparation3

2 Step 2: Connect OPay POS with your terminal using a USB data cable (232 serial protocol).

preparation1

3 Step 3: Set up your OPay POS in the USB connection mode by Menu > SelfcheckoutMode > USB connection. (If you cannot find it, please contact OPay to configure it for you)

preparation1 preparation2 preparation3

4 Step 4: Test it with our serial port emulator before you start the development. You will find the emulator and instructions in the downloaded package.

5 Step 5: Proceed to the development of your application and launch it once thorough testing has been conducted and all aspects are functioning optimally.

Request

Request	Description	Request Data Format
ECHO	Test the connection between terminals	{"type":"echo"}
Purchase	Creat payment order	{"amount":"1","type":"purchase","orderNo":"000000000000001"}
Query Order	Query payment order status	{"type":"Inquiry","orderNo":"000000000000001"}

The amount is denoted in kobo, with "100" kobo equivalent to 1.00 naira.
"orderNo" is your business order number, which should not exceed 32 characters in length.
Customization Requests: For any special requests, kindly reach out to your OPay salesperson to discuss customization options.

Response

Payment Option	Response Sample
Bank Card	{"amount":"60000","cardNumber":"","cardType":"","cashierMethod":"RECEIVE_MONEY","orderNo":"0000000000005A103","orderNumber":"202406281004105131465076736","response":"Transaction Approved","responseCode":"202","transactionNumber":"240628060637386228"}
Bank Transfer	{"amount":"60000","cardNumber":"","cardType":"","cashierMethod":"RECEIVE_MONEY","orderNo":"0000000000005A103","orderNumber":"202406281004105131465076736","response":"Transaction Approved","responseCode":"202","transactionNumber":"240628060637386228"}
QR	{"amount":"50000","cardNumber":"","cardType":"","cashierMethod":"QR_CODE","orderNo":"0000000000005A108","orderNumber":"202406281004112853409427456","response":"Transaction Approved","responseCode":"202","transactionNumber":"240628310637532761"}
USSD	{"amount":"50003","cardNumber":"","cardType":"","cashierMethod":"NO_CARD_CASH","orderNo":"0000000000005A69","orderNumber":"202406271003761288815276032","response":"Transaction Approved","responseCode":"202","transactionNumber":"240627050635491140"}

Response Code

201: CANCEL
202: SUCCESS
203: PENDING
205: FAIL

← POS Integration (API) POS Integration (APP) →