Poll Transaction Status

POST /payment/s2s/status/{transactionId} — poll S2S transaction state.

Poll transaction status using the DigetPay internal transaction ID (not the gateway UUID used by hosted checkout status).

Fin staging — hosted checkout: For hosted checkout payments on Fin, use GET /payment/checkout/status instead. This S2S status endpoint uses a different transaction ID type.

Sequence diagram

sequenceDiagram
    autonumber
    participant Merchant as Your Server
    participant DigetPay as DigetPay API
    participant Gateway as Payment Gateway

    Merchant->>DigetPay: POST /payment/s2s/status/{transactionId}
    DigetPay->>Gateway: Legacy status poll
    Gateway-->>DigetPay: Transaction state
    DigetPay-->>Merchant: Raw gateway response

Request


Method	`POST`
URL	`/v1/payment/s2s/status/{transactionId}`
Auth	`x-api-key`

Parameter	Location	Description
`transactionId`	Path	DigetPay internal transaction UUID

Request payload

{
  "headers": {
    "x-api-key": "YOUR_API_KEY"
  },
  "path": {
    "transactionId": "c09fba3c-59e2-434a-9ec1-5d2e71a44a8d"
  }
}

Critical: Do not confuse this internal S2S transactionId with the hosted checkout gateway transaction UUID. See Transaction Identifiers.

Responses

{
  "success": {
    "status": 200,
    "body": {
      "code": 200,
      "message": "Success",
      "errorCode": null,
      "data": {
        "status": "APPROVED",
        "result": "SUCCESS",
        "paymentId": "c09fba3c-59e2-434a-9ec1-5d2e71a44a8d"
      }
    }
  }
}

{
  "failed": {
    "status": 200,
    "body": {
      "code": 200,
      "message": "Success",
      "errorCode": null,
      "data": {
        "status": "DECLINED",
        "result": "FAILED",
        "paymentId": "c09fba3c-59e2-434a-9ec1-5d2e71a44a8d"
      }
    }
  }
}

For hosted checkout, use GET /payment/checkout/status?id={gatewayTransactionId} instead.

Approved: data.status of APPROVED with result: SUCCESS indicates the S2S transaction completed successfully.

API Reference →

Updated 14 days ago

Did this page help you?