| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns the current status of an Embedded (S2S) transaction using the DigetPay internal transaction ID.
Use this endpoint to verify the latest payment status after a Direct Sale request, especially when the transaction is pending or requires 3-D Secure authentication.
Hosted Checkout merchants: This endpoint is only for Embedded (S2S) integrations. Hosted Checkout integrations must use
GET /payment/checkout/status.
Request
| Method | POST |
| URL | {baseUrl}/payment/s2s/status/{transactionId} |
| Auth | Header x-api-key (required) |
Path Parameters
| Parameter | Required | Description |
|---|---|---|
transactionId | Yes | DigetPay internal transaction ID returned by the Direct Sale API |
Critical: Use the Embedded transaction ID returned from the Direct Sale response. Do not use the Hosted Checkout gateway transaction ID.
Request example
{
"headers": {
"x-api-key": "YOUR_API_KEY"
},
"path": {
"transactionId": "c09fba3c-59e2-434a-9ec1-5d2e71a44a8d"
}
}Transaction flow
sequenceDiagram
autonumber
participant Merchant as Your Server
participant API as DigetPay API
participant Gateway as Payment Gateway
Note over Merchant: Use after Direct Sale returns PENDING or 3DS
Merchant->>API: POST /payment/s2s/status/{transactionId}
API->>Gateway: Retrieve latest transaction status
Gateway-->>API: APPROVED / DECLINED / PENDING
API-->>Merchant: status, result, paymentId
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"
}
}
}
}{
"failed_not_found": {
"status": 404,
"body": {
"statusCode": 404,
"message": "Transaction not found",
"error": "Not Found"
}
}
}{
"failed_unauthorized": {
"status": 401,
"body": {
"statusCode": 401,
"message": "Missing API key",
"error": "Unauthorized"
}
}
}Response fields
| Field | Description |
|---|---|
status | Current gateway status (APPROVED, DECLINED, PENDING) |
result | Overall transaction result (SUCCESS or FAILED) |
paymentId | DigetPay payment reference |
Payment confirmed: Consider the transaction successful only when
statusisAPPROVEDandresultisSUCCESS.
For transactions requiring 3-D Secure, continue polling this endpoint or wait for the webhook notification before fulfilling the order.
Different ID types: Embedded Integration uses the internal
transactionId, while Hosted Checkout uses the gateway transaction ID withGET /payment/checkout/status.