Skip to main content

Search Transaction Refunds

URL

The endpoint and http method information to search refund transactions are stated below.

GET/payment-reporting/v1/refund-transactions

Request Parameters

Refund transactions search can be done using the following parameters.

id
number

ID of refund item to search

paymentId
number

ID of payment

paymentTransactionId
number

ID of payment transaction

buyerMemberId
number

ID of buyer member associated with the payment

conversationId
string

conversationId value that sent in payment refund request by merchant

status
Status

Returns SUCCESS for successful refunds; FAILURE for failed refunds See: Refund Status

Values:
ACTIVE
PASSIVE
currency
Currency

The currency that collection is done in. See: Currencies

Values:
TRY
USD
EUR
GBP
CNY
ARS
BRL
AED
IQD
AZN
KZT
isAfterSettlement
boolean

Whether the refund is after the payout

minPaidPrice
decimal

Minimum amount of refund

maxPaidPrice
decimal

Maximum amount of refund

minCreatedDate
date

Minimum date of refund

maxCreatedDate
date

Maximum date of refund

page
number

Page number for pagination

size
number

Page size for pagination

Response Parameters

The parameters returned as a result of the payment are also subject to the rules specified in the Response Formats section of the API documentation home page. The object structure in the response is as follows:

id
number

ID of refund item

createdDate
date

Date and time that refund is done

status
RefundStatus

Returns SUCCESS for successful refunds; FAILURE for failed refunds

Values:
SUCCESS
FAILURE
refundDestinationType
string

If refund destination is card or payment provider, this value returns as PROVIDER. If refund destination is wallet, this value returns as WALLET. See: Refund Type

refundPrice
decimal

Refunded amount for payment item

refundBankPrice
decimal

Refunded bank amount for payment item

refundWalletPrice
decimal

Refunded wallet amount for payment item

conversationId
string

conversationId value that sent in payment refund request by merchant

authCode
string

authCode value of the payment transaction related to the refund

hostReference
string

hostReference value of the payment transaction related to the refund

transId
string

transId value of the payment transaction related to the refund

isAfterSettlement
boolean

Whether the refund is after the payou

paymentType
PaymentType
Values:
CARD_PAYMENT
DEPOSIT_PAYMENT
WALLET_PAYMENT
CARD_AND_WALLET_PAYMENT
BANK_TRANSFER
APM
error
PaymentError

Error detail info, returns if the refund is failed. See: Payment Error Groups

paymentTransactionId
number

ID of payment transaction for the refund

Sample Codes

You can review the sample codes in the open source Craftgate API clients.

Loading..