Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

Your PayBridgeNP API key. Obtain one from the dashboard under Settings → API Keys. Prefix: sk_test_ for testing, sk_live_ for production.

Path Parameters

id
string
required

Refund ID (prefix: ref_).

Response

Refund object.

id
string
Example:

"ref_01j9x2k3m4n5p6q7r8s9t0u1v2"

livemode
boolean

true when created with a live key, false for sandbox.

paymentId
string
Example:

"pay_01j9x2k3m4n5p6q7r8s9t0u1v2"

projectId
string
mode
enum<string>
Available options:
sandbox,
live
amount
integer

Refunded amount in paisa.

Example:

10000

currency
string
Example:

"NPR"

reason
enum<string>
Available options:
customer_request,
duplicate,
fraudulent,
other
status
enum<string>

succeeded - refund processed. requires_action - eSewa: must be processed manually via merchant portal. failed - provider rejected the refund.

Available options:
processing,
succeeded,
failed,
requires_action
providerRefundId
string | null

Provider's refund reference (Khalti only).

failureReason
string | null

Set when status is failed or requires_action.

notes
string | null
mobileNumber
string | null
createdAt
string<date-time>
updatedAt
string<date-time>