Status queries & recovery

Sometimes a request ends without a clear answer. POS+ may have been closed mid-transaction, the request may have failed with PP_A2A_014 (timeout) or PP_A2A_007 (unexpected error), or your own app may have crashed after the customer paid. POS+ always keeps the authoritative record of the order, so ask POS+ what happened before you retry. Retrying a payment blindly can charge the customer twice.

Query a transaction

getTransactionResult looks up the order by orderCode and returns the transaction with the given transactionId, in the same shape as a startPayment response. Read status to learn the final state (SUCCESS, FAIL, CANCEL, WAITING, NOT_RESPONSE, NONE). POS+ opens no payment screen and charges nothing.

transactionId is the id of the payment response you received earlier. If you never received a response, you don't know the transaction id, so use getOrderResult instead.

If the order has no transaction with that id, the request fails with PP_A2A_016.

Parameters

final tx = await _pluspay.getTransactionResult(
  PPTransactionResultRequestModel.toRequest(
    orderCode: 'ORD001',
    transactionId: 'TX-123',
  ),
);

print(tx.status);    // e.g. "SUCCESS"
print(tx.totalPaid);

Query an order

getOrderResult returns the order totals and every transaction on the order, including transactions that were not started by your app (for example payments taken on the web or on another device). Unlike startOrderPayment it does not open a payment screen.

For each item in results, completed is true only when the transaction status is SUCCESS, and data holds the transaction details. If the order cannot be fetched (for example an unknown order code), the request fails with PP_A2A_012.

Parameters

final order = await _pluspay.getOrderResult(
  PPOrderResultRequestModel.toRequest(orderCode: 'ORD001'),
);

print('${order.status} paid=${order.totalPaid} due=${order.amountDue}');
for (final r in order.results) {
  print('${r.data?.id} completed=${r.completed}');
}

Technical cancel

technicalCancel reverses a card transaction on the payment terminal and reports the outcome to PlusPay. Use it when a card payment went through but your side of the sale could not be completed and the payment must be reversed. For regular, user-initiated cancellations use cancelPayment.

On success the response is { order_code, transaction_id, status: "SUCCESS" }. If the reversal fails, the request fails with PP_A2A_012.

Parameters

final res = await _pluspay.technicalCancel(
  PPTechnicalCancelRequestModel.toRequest(
    orderCode: 'ORD001',
    transactionId: 'TX-123',
  ),
);

print(res.status); // "SUCCESS"

Recommended recovery flow

1. A payment request failed with PP_A2A_014 or PP_A2A_007, or your app restarted before it received a result. Do not retry the payment yet.
2. If you have the transactionId, call getTransactionResult. Otherwise call getOrderResult with the orderCode you generated.
3. If the transaction is SUCCESS, treat it as paid. If you cannot complete the sale on your side, reverse it with technicalCancel (or cancelPayment).
4. If there is no transaction, or it is FAIL / CANCEL, it is safe to retry the payment.
5. If a request fails with PP_A2A_015, POS+ is still processing an earlier request. Wait for that request to finish, then query.

Continue to Error handling.