PurchaseOK

Purpose

The IPCPurchaseOK method is a client-side redirect that sends transaction data to the merchant’s URL_OK after a successful payment. This is triggered in the customer’s browser and is not a secure server-to-server notification.

Important:
Do not rely on IPCPurchaseOK for payment confirmation.
Always use IPCPurchaseNotify for secure, server-to-server verification.

When myPOS Triggers This Method

A payment is successfully processed
The customer’s browser is redirected to your URL_OK
Transaction data is sent via GET or POST (depending on integration)

Parameters Sent via Redirect

Parameter	Example	Type	Description
IPCmethod	IPCPurchaseOK	String	Name of the API method.
SID	000000000000010	String	Store ID in the myPOS system.
Amount	23.45	Double	Transaction amount.
Currency	EUR	A(3)	ISO currency code.
OrderID	201203319999999	String	Merchant’s reference to the order.
IPC_Trnref	12345678923	String	myPOS transaction reference.
RequestDateTime	2012-03-31 23:59:59	DateTime	Date and time of the payment request.
RequestSTAN	123456	N(6)	System Trace Audit Number (sequential).
BillingDescriptor	MYPOS *BillingDescriptor	String	Text shown on the customer’s bank statement.
Signature	BASE64…	BASE64	Hash of all above fields (always the last parameter). Used to verify integrity.

Example Redirect Request

GET /your_ok_handler.php?IPCmethod=IPCPurchaseOK&SID=000000000000010&Amount=50.00&Currency=EUR&OrderID=1440146333&IPC_Trnref=813705&RequestSTAN=000006&RequestDateTime=2015-08-21 10:39:37&Signature=your_generated_signature

Sample Response Data (GET Array)

Array (
    [IPCmethod] => IPCPurchaseOK
    [SID] => 000000000000010
    [Amount] => 50.00
    [Currency] => EUR
    [OrderID] => 1440146333
    [IPC_Trnref] => 813705
    [RequestSTAN] => 000006
    [RequestDateTime] => 2015-08-21 10:39:37
    [Signature] => <base64-encoded signature>
)

Security Note

Always verify the signature to confirm the request really comes from myPOS.
Do not use this method for critical payment confirmation.