Refund a previously successful payment (full or partial) using the gateway transaction ID.

Endpoint

Fin Staging Base URL

https://fin-api.digetpay.com/v1

Request Body

Example Request

{
  "transactionId": "2232e99b-0257-47d5-bbfd-022c8951767f",
  "amount": 0.20
}

Refund Flow

sequenceDiagram
    autonumber

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

    Merchant->>API: POST /payment/refund
    API->>Gateway: Process refund
    Gateway-->>API: Refund accepted
    API-->>Merchant: result, refundId

    Note over Merchant,API: Verify refundStatus using Query Transaction Status

Partial refunds

DigetPay supports both full and partial refunds.

• A transaction can be refunded in multiple partial refunds until the original payment amount is fully refunded.
• Each refund amount must be greater than 0.01 and must not exceed the remaining refundable balance.
• After each successful refund, the refundStatus returned by the Query Transaction Status API changes accordingly:
  • NONE → No refunds processed
  • PARTIAL → One or more partial refunds processed
  • FULL → The payment has been fully refunded

Responses

{
  "success": {
    "status": 200,
    "body": {
      "code": 200,
      "message": "Success",
      "errorCode": null,
      "data": {
        "result": "accepted",
        "referenceId": "2026001124",
        "paymentId": "0808779145497567115585",
        "message": "Refund Created Successfully!",
        "amount": "0.20",
        "refundId": "1046772"
      }
    }
  }
}

{
  "failed": {
    "status": 400,
    "body": {
      "code": 400,
      "message": "Refund amount more than sale amount",
      "errorCode": "400",
      "data": null
    }
  }
}

{
  "failed_unauthorized": {
    "status": 401,
    "body": {
      "statusCode": 401,
      "message": "Missing API key",
      "error": "Unauthorized"
    }
  }
}

Response Fields