Postman Collection

Import the official Postman files to test all merchant APIs with JSON request and response bodies.

The Postman collection uses the same JSON payloads documented in Quick Start. Each request includes Success and Failed example responses.

Files

Download from the DigetPay staging backend repository (docs/postman/):

DigetPay-Fin.postman_collection.json
DigetPay-Fin.postman_environment.json

Or from GitHub: DigetPay staging backend — docs/postman

Import steps

Open Postman → Import
Import both JSON files
Select environment DigetPay Fin
Set apiKey to your DigetPay merchant API key

Important: Use your Fin staging API key only. Do not import production keys into shared Postman workspaces.

Environment variables

Variable	Purpose
`baseUrl`	`https://fin-api.digetpay.com/v1`
`apiKey`	DigetPay merchant API key
`sessionId`	Auto-set after Create Payment Link
`gatewayTransactionId`	gateway UUID for Status and Refund
`refundAmount`	Amount to refund

{
  "baseUrl": "https://fin-api.digetpay.com/v1",
  "apiKey": "YOUR_STAGING_API_KEY",
  "sessionId": "",
  "gatewayTransactionId": "",
  "refundAmount": "0.20"
}

Collection requests

#	Request	Method	Endpoint
1	Create Payment Link	`POST`	`/payment/checkout/intiate`
2	Query Transaction Status	`GET`	`/payment/checkout/status?id={gatewayTransactionId}`
3	Process Refund	`POST`	`/payment/refund`

Sample request bodies (JSON)

Create Payment Link:

{
  "merchantOrderId": "PAY-POSTMAN-001",
  "amount": 0.20,
  "currency": "SAR",
  "customerPhone": "501223324",
  "successUrl": "https://fin-admin.digetpay.com/pay/checkout/success",
  "failureUrl": "https://fin-admin.digetpay.com/pay/checkout/failure"
}

Process Refund:

{
  "transactionId": "{{gatewayTransactionId}}",
  "amount": 0.20
}

Flow

Run Create Payment Link → open redirectUrl and pay
Set gatewayTransactionId in the environment (gateway UUID)
Run Query Transaction Status
Run Process Refund with the same UUID

Pass: Status returns transactionStatus: SUCCESS and refund returns result: accepted.

Common failure: Using sessionId instead of gatewayTransactionId for steps 3–4.

Each request includes Success and Failed example responses in the collection.