5. Tracking Code
You can use this service to query your payment using the `TrackingCode` you provided at the time of the transaction. This service returns all payments associated with the specified `TrackingCode`.
Payment Query (TrackingCode)
GET {{Private Base Address}}/api/paywall/private/query/by/trackingcode
The payment query service using the tracking number (TrackingCode) returns a maximum of 100 records.
apikeyprivate
string
Yes
Public Key obtained from the merchant panel.
apiclientprivate
string
Yes
Public Client obtained from the merchant panel.
merchantuniquecode
string
Optional
Unique tracking code assigned by you for the payment.
trackingcode
string
Yesa
Tracking code (TrackingCode) assigned by you for the payment.
Example Code:
using System;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;
public class Program
{
private static readonly HttpClient client = new HttpClient();
private static async Task Main()
{
client.DefaultRequestHeaders.Add("apikeyprivate", "%PRIVATEKEY%");
client.DefaultRequestHeaders.Add("apiclientprivate", "%PRIVATECLIENT%");
client.DefaultRequestHeaders.Add("merchantuniquecode", "%MerchantUniqueCode%"); // Opsiyonel
client.DefaultRequestHeaders.Add("trackingcode", "%TrackingCode%");
var response = await client.GetAsync("{{Private Base Address}}/api/paywall/private/query/by/trackingcode");
var responseString = await response.Content.ReadAsStringAsync();
var responseObject = JsonConvert.DeserializeObject<Response>(responseString);
Console.WriteLine(responseObject.Body.Paywall.StatusName);
}
public class Response
{
public int ErrorCode { get; set; }
public bool Result { get; set; }
public string Message { get; set; }
public Body Body { get; set; }
}
public class Body
{
public List<PaywallList> List { get; set; }
}
public class PaywallList
{
public int PaymentId { get; set; }
public int ActivityId { get; set; }
public bool Status { get; set; }
public string StatusName { get; set; }
// Define other properties as needed...
}
}Parameter Descriptions (Returns a list):
PaymentId
int
Payment ID
UniqueCode
Guid
Unique tracking number generated by Paywall for the payment
MerchantUniqueCode
string
Unique tracking number generated by Paywall for the payment
TrackingCode
string
Tracking number provided by the merchant at the time of payment initiation
ActivityId
int
Identifier of the last payment activity
PaymentGatewayId
int
Identifier of the payment provider through which the transaction was processed
PaymentGatewayName
string
Name of the payment provider through which the transaction was processed
PaymentGatewayProviderName
string
System name of the payment provider through which the transaction was processed
IsThreeDSecure
bool
Is the transaction 3D secure?
IsNonThreeDSecure
bool
Is the transaction Non-3D secure?
IsInsuranceSecure
bool
Is the transaction insurance-specific (first 8 and last 4 digits)?
IsProvision
bool
Is the transaction pre-authorized?
IsOtp
bool
Is the transaction performed using the OTP method?
AnySuccessPayment
bool
Is there any successful sale within the transaction scope?
AnySuccessRefund
bool
Is there any successful refund within the transaction scope?
AnySuccessPartialRefund
bool
Is there any successful partial refund within the transaction scope?
AnySuccessCancel
bool
Is there any successful cancellation within the transaction scope?
Status
boolean
Status of the last activity, true: successful / false: failed
StatusName
string
Payment status
StatusId
int
Payment status identifier
TypeName
string
Type of the last payment activity
TypeId
int
Identifier of the last payment activity type
Installment
int
Installment information
CurrencyId
int
Payment currency identifier
CurrencyName
string
Payment currency
PaymentMethodId
int
Payment method identifier See: Payment Methods
PaymentMethodName
string
Payment method
PaymentChannelId
int
Payment channel identifier See: Payment Channels
PaymentChannelName
string
Payment channel
PaymentTagId
int
Payment tag identifier
PaymentTagName
string
Payment tag
CardNumber
string
Masked card number
CardOwnerName
string
Masked cardholder name
CardBankId
int
Identifier of the card's bank
CardBankName
string
Name of the card's bank
CardBrandId
int
Identifier of the card brand
CardBrandName
string
Name of the card brand
CardTypeId
int
Identifier of the card type
CardTypeName
string
Name of the card type
CardFamilyId
int
Identifier of the card family
CardFamilyName
string
Name of the card family
LastActivityDateTime
DateTime
Date and time of the last transaction related to the payment
PaymentAmount
decimal
Total payment amount
ActivityAmount
decimal
Last transaction amount
Example: If a transaction with a main amount of 1000 TL has a partial refund of 100 TL, this parameter will return 100.
IP
string
IP address to which the transaction was sent
ClientIP
string
IP address of the device used at the time of the transaction
AppliedInterest
bool
Was installment interest applied to the payment?
InterestRate
decimal?
Applied installment interest rate
CommissionRate
decimal?
Commission information applied by the payment provider
Returns the value you configured in the Paywall panel.
OriginalAmount
decimal
Original payment amount
Example: If the payment amount is 1000 TL and after applying a 100 TL installment interest the total charged becomes 1100 TL, this parameter will return 1000 TL as the original amount before interest was applied.
InterestAmount
decimal?
If applicable, the applied installment interest amount
CommissionAmount
decimal
Commission amount applied to the payment by the payment institution/bank
UsedSavedCard
bool
Was the payment made using a saved card?
UsedTempCard
bool
Was the payment made using a client-side tokenized card?
Activities
List
All actions related to the transaction (Created, Sale Started, Sale Failed, Cancellation Successful, etc.)
IsFullyRefunded
bool
Information on whether the transaction has been fully canceled/refunded.
RemainingRefundAmount
decimal
Total refundable amount. This amount decreases as partial refunds are made.
{
"ErrorCodeType": 1,
"ErrorMessage": null,
"ErrorCode": 0,
"Result": true,
"Message": "",
"Body": {
"List": [
{
"PaymentId": 4045719,
"UniqueCode": "5cd67b1e-9b1d-49ee-bf73-96b9d004a73f",
"MerchantUniqueCode": "b735a618-f775-434e-9a96-b5f3d0502b14",
"TrackingCode": "tracking-code-1234567890",
"ActivityId": 8907405,
"PaymentGatewayId": 1570,
"PaymentGatewayName": "ProviderConnectionName",
"PaymentGatewayProviderName": "ProviderSystemName",
"IsThreeDSecure": false,
"IsNonThreeDSecure": true,
"IsInsuranceSecure": false,
"IsProvision": true,
"IsOtp": false,
"AnySuccessPayment": false,
"AnySuccessRefund": false,
"AnySuccessPartialRefund": false,
"AnySuccessCancel": false,
"Error": {
"AnyError": false,
"ErrorType": 0,
"ErrorMessage": ""
},
"Status": false,
"StatusName": "Finansallaştırma Bekliyor",
"StatusId": 3,
"TypeName": "Satış",
"TypeId": 1,
"Installment": 1,
"CurrencyId": 1,
"CurrencyName": "TRY",
"PaymentMethodId": 4,
"PaymentMethodName": "Half Direct Payment",
"PaymentChannelId": 0,
"PaymentChannelName": null,
"PaymentTagId": 0,
"PaymentTagName": null,
"CardNumber": "552879******0008",
"CardOwnerName": "Enes Selman Tütüncü",
"CardBankId": 55,
"CardBankName": "T.HALK BANKASI A.Ş.",
"CardBrandId": 1,
"CardBrandName": "Master Card",
"CardTypeId": 1,
"CardTypeName": "Credit",
"CardFamilyId": 5,
"CardFamilyName": "Paraf",
"LastActivityDateTime": "2025-06-04T23:39:29.0246554",
"PaymentAmount": 1000.00,
"ActivityAmount": 1000.00,
"IP": "78.190.218.158",
"ClientIP": null,
"AppliedInterest": false,
"InterestRate": 0.00,
"CommissionRate": 0.00,
"OriginalAmount": 1000.00,
"InterestAmount": 0.00,
"CommissionAmount": 0.00,
"UsedSavedCard": true,
"UsedTempCard": false
},
{
"PaymentId": 4045718,
"UniqueCode": "3208b4c0-646b-453a-b555-4685bd62867b",
"MerchantUniqueCode": "a2720c3b-7490-41cc-adfd-1edfbf5d1177",
"TrackingCode": "tracking-code-1234567890",
"ActivityId": 8907402,
"PaymentGatewayId": 1570,
"PaymentGatewayName": "ProviderConnectionName",
"PaymentGatewayProviderName": "ProviderSystemName",
"IsThreeDSecure": false,
"IsNonThreeDSecure": true,
"IsInsuranceSecure": false,
"IsProvision": true,
"IsOtp": false,
"AnySuccessPayment": false,
"AnySuccessRefund": false,
"AnySuccessPartialRefund": false,
"AnySuccessCancel": false,
"Error": {
"AnyError": false,
"ErrorType": 0,
"ErrorMessage": ""
},
"Status": false,
"StatusName": "Finansallaştırma Bekliyor",
"StatusId": 3,
"TypeName": "Satış",
"TypeId": 1,
"Installment": 1,
"CurrencyId": 1,
"CurrencyName": "TRY",
"PaymentMethodId": 4,
"PaymentMethodName": "Half Direct Payment",
"PaymentChannelId": 0,
"PaymentChannelName": null,
"PaymentTagId": 0,
"PaymentTagName": null,
"CardNumber": "552879******0008",
"CardOwnerName": "Enes Selman Tütüncü",
"CardBankId": 55,
"CardBankName": "T.HALK BANKASI A.Ş.",
"CardBrandId": 1,
"CardBrandName": "Master Card",
"CardTypeId": 1,
"CardTypeName": "Credit",
"CardFamilyId": 5,
"CardFamilyName": "Paraf",
"LastActivityDateTime": "2025-06-04T23:39:26.7114128",
"PaymentAmount": 1000.00,
"ActivityAmount": 1000.00,
"IP": "78.190.218.158",
"ClientIP": null,
"AppliedInterest": false,
"InterestRate": 0.00,
"CommissionRate": 0.00,
"OriginalAmount": 1000.00,
"InterestAmount": 0.00,
"CommissionAmount": 0.00,
"UsedSavedCard": true,
"UsedTempCard": false
},
{
"PaymentId": 4045717,
"UniqueCode": "2da4e8f0-91e2-4a99-8087-0f117be3f648",
"MerchantUniqueCode": "94fe0960-396a-49f5-a290-bc6454bd12bd",
"TrackingCode": "tracking-code-1234567890",
"ActivityId": 8907399,
"PaymentGatewayId": 1570,
"PaymentGatewayName": "ProviderConnectionName",
"PaymentGatewayProviderName": "ProviderSystemName",
"IsThreeDSecure": false,
"IsNonThreeDSecure": true,
"IsInsuranceSecure": false,
"IsProvision": true,
"IsOtp": false,
"AnySuccessPayment": false,
"AnySuccessRefund": false,
"AnySuccessPartialRefund": false,
"AnySuccessCancel": false,
"Error": {
"AnyError": false,
"ErrorType": 0,
"ErrorMessage": ""
},
"Status": false,
"StatusName": "Finansallaştırma Bekliyor",
"StatusId": 3,
"TypeName": "Satış",
"TypeId": 1,
"Installment": 1,
"CurrencyId": 1,
"CurrencyName": "TRY",
"PaymentMethodId": 4,
"PaymentMethodName": "Half Direct Payment",
"PaymentChannelId": 0,
"PaymentChannelName": null,
"PaymentTagId": 0,
"PaymentTagName": null,
"CardNumber": "552879******0008",
"CardOwnerName": "Enes Selman Tütüncü",
"CardBankId": 55,
"CardBankName": "T.HALK BANKASI A.Ş.",
"CardBrandId": 1,
"CardBrandName": "Master Card",
"CardTypeId": 1,
"CardTypeName": "Credit",
"CardFamilyId": 5,
"CardFamilyName": "Paraf",
"LastActivityDateTime": "2025-06-04T23:39:25.2136514",
"PaymentAmount": 1000.00,
"ActivityAmount": 1000.00,
"IP": "78.190.218.158",
"ClientIP": null,
"AppliedInterest": false,
"InterestRate": 0.00,
"CommissionRate": 0.00,
"OriginalAmount": 1000.00,
"InterestAmount": 0.00,
"CommissionAmount": 0.00,
"UsedSavedCard": true,
"UsedTempCard": false
}
]
}
}Last updated