Status van transactie controleren

Een statusaanvraag voor een transactie haalt het resultaat op van een eerdere transactie. Het belangrijkste gebruik is herstel: als je app de verbinding verloor of opnieuw opstartte tijdens een betaling en nooit de reactie zag, vertelt een statusaanvraag je wat er daadwerkelijk gebeurde zodat je niet dubbel belast of een verkoop in onzekerheid achterlaat.

Vereiste: een live sessie.

De oproep

viewModelScope.launch {
    clientSDK.sendTransactionStatusRequest(
        RetailerMessageArguments.StatusRequestMessageArguments(
            MessageReference(messageCategory = "Payment")
        )
    )
}

• MessageReference — identificeert welk bericht/transactie gecontroleerd moet worden. De messageCategory selecteert het soort operatie (bijv. een betaling). Zie de API-referentie voor de volledige MessageReference-velden als je een specifiek bericht wilt targeten in plaats van het laatste.

Standaard haalt dit de status op van de laatst voltooide transactie in de genoemde categorie.

Het resultaat lezen

when (message) {
    is SuccessRetailerTransactionStatusResponse -> { /* lees het herstelde resultaat */ }
    is ErrorRetailerTransactionStatusResponse   -> { /* geen overeenkomende transactie / mislukt */ }
    is RetailerDisplayRequest                   -> { /* voortgang, indien aanwezig */ }
}

Een succesvolle statusreactie bevat het oorspronkelijke resultaat van de transactie, inclusief de POITransactionID — wat een statusaanvraag een manier maakt om een POI-transactie-ID te herstellen die je nodig hebt voor een terugdraaiing maar niet hebt opgeslagen. Zie Gids: een transactie terugdraaien.

Wanneer te gebruiken

• Na een verbroken verbinding tijdens een betaling — bevestig of de betaling is doorgegaan voordat je het opnieuw probeert.
• Nadat je app opnieuw is opgestart midden in een transactie — herstel het resultaat dat je hebt gemist.
• Om een POITransactionID op te halen voor een terugdraaiing wanneer je deze niet hebt vastgelegd tijdens de betaling.

Voor routinematige betalingen waarbij je de reactie normaal ontving, heb je geen statusaanvraag nodig — je hebt het resultaat al.

Gerelateerd

• Gids: een betaling uitvoeren — de transactie waarvan je de status controleert.
• Gids: een transactie terugdraaien — gebruikt de POITransactionID die een statusaanvraag kan herstellen.
• Sessie- en loginlevenscyclus — de scenario’s van verloren verbinding die statuscontroles noodzakelijk maken.
• API-referentie (sdk-doc.zip) — volledige MessageReference-velden.