Purpose
This method is used by Merchant to get the current status of a previously executed payment. The myPOS Checkout API will return an XML with detailed information about a specific OrderID. This method is intended to be utilized by the Merchant in his website back-end. The Merchant could decide whether or not to use this method.
Method Properties
Property |
Typical value |
Type |
Required |
Description |
---|---|---|---|---|
OrderID | 201203319999999 | String | YES | Placeholder for the merchant. Used to put some data that will help the merchant to refer payments to orders. Up to 255 characters. |
OutputFormat | XML | String | NO | The output format of data. The property can be “XML” or “JSON”. If it is not specified in the request, the default value is “XML”. |
Response Properties
Property |
Typical value |
Type |
Description |
---|---|---|---|
OrderID | 201203319999999 | String | Placeholder for the merchant. Used to put some data that will help the merchant to refer payments to orders. Up to 255 characters. |
PaymentMethod | 1 | N(1) | (Conditional) If a property is not sent, the customer is redirected to a myPOS Hosted payment page with selection of all payment methods myPOS Checkout supports;
1 – Redirects the customer to a card-only checkout. |
PaymentStatus | 1 | N(1) | 1 – Successful payment 2 – Pending payment 3 – Unsuccessful payment |
PaymentReference | MTCOR0123456XXK7 | String | Payment Reference of the transaction |
Example Of The Request
Request:
[IPCmethod] => IPCGetPaymentStatus
[IPCVersion] => 1.4
[SID] => 95357
[KeyIndex] => 1
[walletnumber] => 40590833956
[OrderID] => 1601551599
[OutputFormat] => xml
[Signature] => ENfm3uk62FEccNisZs5nSm0ZpsYTb4RLFkpjoV1wVGfbu/jH1V47s4RRW/vV7p7zEbj3om6TIMkpj7rD4pEqeB43lM+jtG+bq0tJuBo3iiNSdV2KhesNJPkjbc5RDzXf7mMhcFaELs2QhR1brs44UFEirb1WSJ4Sr6UOqQtcfsQ=
Example Of The XML Response
<ipc_response>
<IPCMethod>IPCGetPaymentStatus</IPCMethod>
<OrderID>1601551599</OrderID>
<PaymentStatus>1</PaymentStatus>
<Amount>50.00</Amount>
<Currency>EUR</Currency>
<IPC_Trnref>131753</IPC_Trnref>
<PaymentReference>MTCOR0124565XXK7</PaymentReference>
<DateTime>2020-10-01 14:26:52</DateTime>
<FeeAmount>1.60</FeeAmount>
<Status>0</Status>
<StatusMsg>Success</StatusMsg>
<Signature>DJTrVxmxD/TCW52T1K0g6g9rptt1nM6Af1JvsPAoXg8JBWGDB/GG362y+Co4it0/ckwr4RjY1VrTiD2ZOO1s56UpeMtLLJM9EtwYcwZmzgyhooUvPx04W3wuH0qJ+HRC6nWIbE+lo45M1H/yyaM/Qq5smqg/+g+zOIM/1stO67g=</Signature>
</ipc_response>