get
https://fin-api.digetpay.com/v1/payment/checkout/status
Returns the latest payment and refund status for a completed transaction using the gateway transaction ID.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Recommended usage: Call this endpoint after the customer completes payment to verify the final transaction status. Do not rely on the browser redirect alone—always confirm using the Status API or webhooks.
Endpoint
| Method | GET |
| URL | {baseUrl}/payment/checkout/status?id={gatewayTransactionId} |
| Authentication | Header x-api-key |
Fin Staging Base URL
https://fin-api.digetpay.com/v1Important: The
idparameter must be the gateway transaction ID (UUID).Do not use the checkout session ID returned by Create Payment Link.
Request Parameters
| Parameter | Location | Required | Description |
|---|---|---|---|
id | Query | Yes | Gateway transaction UUID |
x-api-key | Header | Yes | Merchant API Key |
Example Request
GET /payment/checkout/status?id=2232e99b-0257-47d5-bbfd-022c8951767fHeaders
x-api-key: YOUR_API_KEYor
{
"headers": {
"x-api-key": "YOUR_API_KEY"
},
"query": {
"id": "2232e99b-0257-47d5-bbfd-022c8951767f"
}
}Transaction Flow
sequenceDiagram
autonumber
participant Merchant as Your Server
participant API as DigetPay API
Merchant->>API: GET /payment/checkout/status?id={gatewayTransactionId}
API-->>Merchant: transactionStatus
API-->>Merchant: paymentStatus
API-->>Merchant: refundStatus
Note over Merchant,API: Continue only when transactionStatus = SUCCESS
Responses
{
"success": {
"status": 200,
"body": {
"code": 200,
"message": "Success",
"errorCode": null,
"data": {
"content": [
{
"transactionId": "2232e99b-0257-47d5-bbfd-022c8951767f",
"amount": "0.20",
"transactionStatus": "SUCCESS",
"paymentStatus": "APPROVED",
"refundStatus": "NONE",
"totalRefundAmount": "0.00",
"pan": "5387 7** **** 4254",
"cardScheme": "MC"
}
],
"totalElements": 1
}
}
}
}{
"failed": {
"status": 200,
"body": {
"code": 200,
"message": "Success",
"errorCode": null,
"data": {
"content": [
{
"transactionId": "2232e99b-0257-47d5-bbfd-022c8951767f",
"transactionStatus": "FAILED",
"paymentStatus": "DECLINED",
"refundStatus": "NONE"
}
],
"totalElements": 1
}
}
}
}{
"failed_bad_request": {
"status": 400,
"body": {
"statusCode": 400,
"message": "Missing transaction ID",
"error": "Bad Request"
}
}
}{
"failed_unauthorized": {
"status": 401,
"body": {
"statusCode": 401,
"message": "Missing API key",
"error": "Unauthorized"
}
}
}Response Fields
| Field | Description |
|---|---|
transactionId | Gateway transaction UUID |
transactionStatus | SUCCESS, FAILED, PENDING |
paymentStatus | Gateway authorization result |
refundStatus | NONE, PARTIAL, FULL |
totalRefundAmount | Total refunded amount |
Payment confirmed: Consider the payment successful only when:
transactionStatus = SUCCESSpaymentStatus = APPROVED
Best practice: Store the gateway transaction ID after payment completes and use it for:
- Query Transaction Status
- Process Refund
- Payment reconciliation