Skip to content

Payin Transaction Statement

Purpose

Displays all Payin transactions that are in a terminal state within the specified date range for the merchant. Suitable for reconciling daily payin details and identifying abnormal transactions.

Filter dimension

Filter by Txn Complete Time (transaction completion time).

Statement template

Merchant ID_payin.xlsx

Sample statement

HeaderField descriptionMeaningSample 1Sample 2Enum
AppIDApplication IDThe app’s unique identifier on the platform.b1de8a8f728840739fcb7ab49b02f4cdf65bdb49d4924fb399e341559b02dca6
Txn Create TimeTransaction create timeThe time when the user submitted the order before a transaction was created.31:00.040:00.0
Txn Complete TimeTransaction completion timeThe time when the transaction reached its final status.32:00.057:00.0
User IDUser IDThe platform’s internal unique identifier of the user who initiated the transaction.341678574234541234
Transaction TypeTransaction typeThe type of the order’s transaction; refer to acquiring values.PAYMENTREFUNDPAYMENT: Payment
REFUND: Refund
PAY_LINK: Pay by link
SUBSCRIPTION: Standard subscription
CHARGE_BACK: Chargeback
CHARGE_BACK_ASSIST: Chargeback representment
COLLECTION: VA collection
ADJUSTMENT_INCREASE: Adjustment increase
ADJUSTMENT_DECREASE: Adjustment decrease
OriginalMerchant Txn IDOriginal merchant order IDThe original transaction ID submitted by the merchant system for traceability (e.g., in case of delayed follow-up transactions).3c19e61450645ec4b1a11115518195
Merchant Txn IDMerchant order IDThe merchant-side unique identifier for the initiated transaction.3c19e61450645ec4b1a111155181953c19e07427642abf078f47ac51c1ca
Trade Order IDPlatform order IDThe unique transaction ID generated internally by Checus.TOKEN20230512228823425324O20230505034046314647849721
Txn StatusTransaction statusSuch as success, failure, etc.FAILEDCB RequestSUCCESS: Succeeded
FAILED: Failed
CLOSED: Closed
CB Request: Chargeback hold
CB Reversed: Chargeback reversed
CountryCountryCountry where the transaction was initiated.SAQA
Txn AmountTransaction amountThe original amount of the user’s purchase at the merchant.7100
Txn CurrencyTransaction currency-SARQAR
Payment AmountPayment amountThe actual amount paid by the user.7
Payment CurrencyPayment currency-SAR
Payment Method TypePayment method typeFor example, card payment, bank transfer, etc.CARDCARD
Payment MethodPayment methodSpecific payment method name, e.g., MIDA S, MastercardMADANAPS
Target Org/Card OrgTarget institution / card schemeTarget institution or card organization.MADANAPS
Txn FeeFeeTotal fee amount.
Txn Fee = Rate Fee + Fixed Fee
-1-36.61
Txn Fee CurrencyFee currency-SARQAR
Rate FeePercentage feeProportional fee charged based on the transaction amount.00
Fixed FeeFixed feeFixed charge.-1-36.61
Txn TaxTaxTax withheld/remitted by the platform.-0.2
Txn Tax CurrencyTax currency-SARQAR
Merchant Txn TaxMerchant remitted taxTax amount remitted by the merchant via filing service.-0.3
Merchant Txn Tax CurrencyMerchant remitted tax currency-SARQAR
Merchant Txn Tax RateMerchant remitted tax rateThe tax rate applied to merchant remitted tax.Rates follow local country policy.
Net AmountNet settlement amountThe net income that the platform should settle to the merchant after the transaction (transaction amount minus fees, taxes, etc.).
Net Amount = Txn Amount + Txn Fee + Txn Tax + Merchant Txn Tax
5.5-136.61
Net CurrencyNet settlement currency-SARQAR
Failure ReasonFailure reasonIf the transaction failed, records the reason, e.g., “Card declined”, “Insufficient funds”, “Risk control interception”.Payment was not completed on time.
Trade DescriptionTransaction descriptionDescription filled in by the user, displayed for user approval.subject
ReferenceMerchant custom dataOptional field to record business-side custom information.This is reference
Exchange RateSettlement FX rate (trade-day FX)
Reserved field, currently empty
The settlement FX rate used to calculate the net amount.
Exchange rate TimeSettlement FX effective time
Reserved field, currently empty
The effective time of the settlement FX rate.
Exchange TypeSettlement type
Reserved field, currently empty
Settlement type, e.g., real-time FX.
Fields to be addedReserved fields for new business

Released under the MIT License.