Skip to main content

Retrieve Payment

URL

The endpoint and http method information to inquiry payment in detail are stated below.

GET/payment-reporting/v1/payments/:id

Request Parameters

Payment inquiry can only be made using the payment id value.

id
number
required

Payment ID value to be retrieved

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 the payment

createdDate
date

The date that payment created

price
decimal

Total amount of the payment

paidPrice
decimal

Total amount paid by the buyer. The amount also included in collected from wallet for payments that fully or partially collected from the wallet. Müşterinin ödediği toplam tahsilat tutarı.

walletPrice
decimal

The amount collected from wallet

currency
Currency

Payment currency See: Currencies

Values:
TRY
USD
EUR
GBP
CNY
ARS
BRL
AED
IQD
AZN
KZT
buyerMemberId
number

Buyer member ID related to payment

installment
number

Installment number of the payment

conversationId
string

conversationId value that sent in payment request by merchant

externalId
string

externalId value that sent in payment request by merchant

paymentType
PaymentType
Values:
CARD_PAYMENT
DEPOSIT_PAYMENT
WALLET_PAYMENT
CARD_AND_WALLET_PAYMENT
BANK_TRANSFER
APM
paymentGroup
PaymentGroup
Values:
PRODUCT
LISTING_OR_SUBSCRIPTION
paymentSource
PaymentSource
Values:
API
CHECKOUT_FORM
PAY_BY_LINK
paymentStatus
PaymentStatus
Values:
FAILURE
SUCCESS
INIT_THREEDS
CALLBACK_THREEDS
WAITING
paymentPhase
PaymentPhase
Values:
AUTH
PRE_AUTH
POST_AUTH
paymentChannel
string

paymentChannel value sent by the merchant in the payment request

isThreeDS
boolean

Indicates whether the payment is 3D Secure payment

merchantCommissionRate
decimal

Interest rate to calculate paid price that buyer will pay

merchantCommissionRateAmount
decimal

Interest amount. Equal to the difference between paidPrice and price values

bankCommissionRate
string

Bank commission rate

bankCommissionRateAmount
string

Bank commission rate amount

paidWithStoredCard
boolean

Indicates whether the payment was made with a stored card

binNumber
string

Exist for the payments fully or partially collected from the card. First 8 digits of the card

lastFourDigits
string

Exist for the payments fully or partially collected from the card. Last 4 digits of the card

authCode
string

authCode value retrieved from bank related to the payment

hostReference
string

hostReference value retrieved from bank related to the payment

transId
string

transId value retrieved from bank related to the payment

orderId
string

orderId value retrieved from bank related to the payment

cardType
CardType

Type of the card. Exist for the payments fully or partially collected from the card (See: Card Types)

Values:
CREDIT_CARD
DEBIT_CARD
PREPAID_CARD
cardAssociation
CardAssociation

Card association. Exist for the payments fully or partially collected from the card

Values:
VISA
MASTER_CARD
AMEX
TROY
JCB
UNION_PAY
MAESTRO
DISCOVER
DINERS_CLUB
cardBrand
string

Brand of card. Exist for the payments fully or partially collected from the card

cardHolderName
string

Card holder name surname

bankCardHolderName
string

Card holder name surname retrieved from bank

cardIssuerBankName
string

Name of card issuer bank

mdStatus
string

Payment status retrieved from bank for 3D secure payment

retryCount
string

Retry count while payment is done

refundablePrice
string

Refundable amount

refundStatus
PaymentRefundStatus

Status of refund see: Payment Refund Status

Values:
NO_REFUND
NOT_REFUNDED
PARTIAL_REFUNDED
FULLY_REFUNDED
buyerMember
MemberResponse

Detail info of buyer, if the buyer info sent in payment request.

pos
MerchantPos

POS info that payment is received.

loyalty
Loyalty

Loyalty info that used in payment.

paymentError
PaymentError

Detail information of the error, if the payment received an error.

refunds
ReportingPaymentRefundResponse[]

It contains detailed information about the refund if there is refund information for the payment.

Sample Codes

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

Loading..