The endpoint and http method information to query payment transaction in detail are stated below.
HTTP Method | URL |
---|---|
GET |
/payment-reporting/v1/payments/:id/transactions |
Payment transaction detail query can only be made using the payment ID value.
Parameter Name | Type | Required | Description |
---|---|---|---|
id |
number |
Yes | Payment transacton ID to search |
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:
Parameter Name | Type | Description |
---|---|---|
id |
number |
Payment transaction ID |
name |
string |
The product or service name for the payment transaction description that sent in payment request |
externalId |
string |
External ID value for the payment transaction sent in the payment request |
createdDate |
date |
Create date that the payment request sent |
price |
decimal |
Price for the payment transaction |
paidPrice |
decimal |
Collected paid amount share of full paid amount for the payment transaction |
walletPrice |
decimal |
Amount share collected from wallet of full collected wallet amount for the payment transaction |
refundablePrice |
string |
Refundable amount |
merchantCommissionRate |
decimal |
Interest rate to calculate paid price that buyer will pay |
merchantCommissionRateAmount |
decimal |
Shared interest amount of the payment transaction |
bankCommissionRate |
string |
Bank commission rate |
bankCommissionRateAmount |
string |
Bank commission rate amount |
merchantPayoutAmount |
decimal |
Payout amount share that will be sent to merchant for the payment transaction |
subMerchantMemberId |
number |
Sub-merchant ID related to payment transaction |
subMerchantMemberPrice |
decimal |
Amount share of the sub-merchant for the payment transaction |
subMerchantMemberPayoutRate |
decimal |
Ratio of the amount share to be sent to the sub-merchant regarding the amount share to be sent to the merchant. |
subMerchantMemberPayoutAmount |
decimal |
Amount share that will be payout for the payment transaction |
subMerchantMember |
MemberResponse |
Sub-merchant details of payment transaction See: Seller Information |
transactionStatus |
TransactionStatus |
Status of payment transaction confirmation (See: Payment Item Confirmation Status |
transactionStatusDate |
date |
Date that transaction status updated |
blockageResolvedDate |
date |
Date that the blockage will be resolved |
refundStatus |
PaymentRefundStatus |
Refund status of payment transaction see: Payment Refund Status |
payout |
Payout |
Payout details of merchant, sub-merchant and Craftgate distributed amounts for the payment transaction See: Payment Transaction Distribution of Money Transfer |
payoutStatus |
PayoutStatus |
Payout status for merchant and sub-merchant for the payment transaction See: Payment Transaction Money Transfer Status |
It includes the distribution of the share of the money transfer to be made in relation to the payment, in terms of a specific a transaction, between the merchant and the sub-merchant.
The currency of the money distribution is always TRY
.
Parameter Name | Type | Description |
---|---|---|
paidPrice |
decimal |
Collected amount share for the payment transaction |
currency |
Currency |
See: Currencies |
merchantPayoutAmount |
decimal |
Payout amount share of merchant for the payment transaction (in TRY currency) |
subMerchantMemberPayoutAmount |
decimal |
Payout amount share of sub-merchant for the payment transaction (in TRY currency) |
parity |
decimal |
Parity info for the payment transaction |
bankCommissionRateAmount |
decimal |
Bank commission amount for the payment transaction |
It includes the money sending status for the merchant and the sub-merchant regarding the payment transaction.
Parameter Name | Type | Description |
---|---|---|
merchantStatus |
TransactionPayoutStatus |
Status of payout transaction to merchant See: Payout Status |
merchantStatusDate |
date |
The status date of payout transation to merchant |
subMerchantMemberStatus |
TransactionPayoutStatus |
Status of payout transaction to sub-merchant See: Payout Status |
subMerchantMemberStatusDate |
date |
The status date of payout transation to sub-merchant |
You can review the sample codes in the open source Craftgate API clients.