POST
/
MoneyIn
/
refund
/
{transId}

Authorizations

requestToken
string
header
required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Headers

idempotencyKey
string

A unique ID you can include to prevent duplicating objects or transactions if a request is sent more than once. This key is not generated in Payabli, you must generate it yourself.

Path Parameters

transId
string
required

ReferenceId for the transaction (PaymentId).

Body

amount
number

Amount to refund from original transaction, minus any service fees charged on the original transaction.

The amount provided cannot be greater than the original total amount of the transaction, minus service fees. For example, if a transaction was $90 plus a $10 service fee, you can refund up to $90.

An amount equal to zero will refund the total amount authorized minus any service fee.

ipaddress
string

Recommended. The customer's IP address. This field is used to help prevent fraudulent transactions, and Payabli strongly recommends including this data.

orderDescription
string | null

Text description of the transaction.

Maximum length: 250
orderId
string | null

Custom identifier for the transaction.

Maximum length: 250
refundDetails
object

Object containing details about the refund, including line items and optional split instructions.

source
string | null

Custom identifier to indicate the transaction or request source.

Maximum length: 100

Response

200 - application/json
isSuccess
boolean

Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.

pageidentifier
string | null

Auxiliary validation used internally by payment pages and components.

responseData
object | null

The object containing the response data.

responseText
string | null

Response text for operation: 'Success' or 'Declined'.