Settlement
In the payments ecosystem, transactions are composed of the following processes:- Authorization – The process of approving a cardholder’s transaction to the merchant via the network, based on if a card is valid, business rules are met, and funds are sufficient. If necessary, a temporary hold can be placed on funds.
- Clearing – The process of finalizing the hold on funds and posting the transaction on the cardholder’s account. This process is triggered by the merchant’s capture request.
- Settlement – The process of transferring the funds between the merchant’s and the cardholder’s banks.
- Prior to settlement, authorization and clearing are non-monetary exchanges of transaction information.
- Clearing provides the amount to be debited from issuers and credited to acquirers.
-
Merchants keep authorizations in a batch until they are processed for clearing.
- Most merchants perform batch processing once a day. High volume merchants may have multiple batches.
Settlement reports
Marqeta passes raw network settlement reports to you daily. These reports are sent to Marqeta, split to your bank identification numbers (BINs), and distributed to your SSH File Transfer Protocol (SFTP) server. These files are:- Encrypted with your public key.
-
Delivered daily to your SFTP server.
- Marqeta’s system will periodically check for new files from the network and, once received, will process and forward them within 30 minutes.
- For settlement cycle timing, consult your network.
- Reports are typically received by 3:00 pm UTC daily.
-
For Visa – VSS Reports TC46 (Machine Readable) / TC47 (Human Readable).
- There are various reports inside each format. Reach out to your Visa representative to find out which reports are available for you.
- For Mastercard – T112 (Clearing Data) / T140 (Aggregate Amounts).
- SFTP host name, or IP and port number.
- SFTP file directory structure.
- GPG public key and ID (required for encryption).
- SFTP username.
- BIN (Visa) or ICA (Mastercard).
Clearing webhooks
Marqeta customers should ingest the following transaction types, as appropriate for your program, to perform reconciliation:-
Debit
-
authorization.clearing -
authorization.clearing.atm.withdrawal -
authorization.clearing.cashback -
authorization.clearing.quasi.cash -
authorization.clearing.representment
-
-
Credit
-
refund- Includes sales reversals and any other credit type not listed below.
-
refund.authorization.clearing -
original.credit.authorization.clearing
-
-
type– Determines whether the transaction is a debit or a credit. -
batch_number– Details which batch the file came in and can provide accurate date/time of when the batch was sent from the network.- Should be used to determine cut-off times.
-
settlement_date– Determines all clearings associated with the date of settlement you are reconciling. -
created_time– Determines the time Marqeta created the clearing webhook.- Use
batch_numberfor network accurate settlement times.
- Use
-
fees– Determines if any fees are associated with the transaction.- Can be used to calculate interchange, if required.
-
network_reference_id– References the transaction identifier from the network.Visa– Remove 0002 prefix.
JSON
Visa settlement reconciliation
Visa offers several reports that you can reconcile against to allow for different reconciliation periods:- VSS-110 – Daily Summary Report.
- VSS-110-M – Monthly Summary Report.
- Second Sunday in March to first Sunday in November – 10:00 GMT.
-
First Sunday in November to second Sunday in March – 11:00 GMT.
- You should confirm these with your Visa representative.
- Clearing received before cut-off is reported under VISANET SETTLEMENT SERVICE.
- Clearing received after cut-off is reported under INTERNATIONAL SETTLEMENT SERVICE.
- Processing Marqeta clearing webhooks.
- Summing transaction amount (credits - debits).
- Counting transaction types.
-
Using
batch_numberto group by batch.- The first 10 digits of the batch number for batch date/time, for example,
2020113011464516.
- The first 10 digits of the batch number for batch date/time, for example,
-
Comparing Visa’s settlement report to Marqeta’s summary of count and amount.
- Additional fees may be charged by Visa, and they should appear on the report if you need to deduct them.
Mastercard settlement reconciliation
Mastercard offers several reports that you can reconcile against to allow for different reconciliation periods:- T112 – Transactional Clearing Data
- T140 – Aggregate Settlement Report
-
There are six cycles in a day.
- Speak with your Mastercard representative to find out which cycle(s) apply to you.
- Processing Marqeta clearing webhooks.
- Summing transaction amount (credits – debits).
- Counting transaction types.
-
Using
batch_numberto group by cycle.- The final digit of the batch number can be used to determine the clearing cycle number, for example, 2020113011 46451
6
- The final digit of the batch number can be used to determine the clearing cycle number, for example, 2020113011 46451
-
Comparing Mastercard’s settlement report to Marqeta’s summary of amount.
- Additional fees may be charged by Mastercard, and they should appear on the report if you need to deduct them.
Settlement and reconciliation responsibilities
If you have a card program in Europe, there are several responsibilities that you and Marqeta maintain. These responsibilities include:| Responsibility | Powered By | Managed By |
|---|---|---|
| Ingest clearing webhooks and process credits and debits into the settlement process | You | You |
| Deliver clearing webhooks to the customer | Marqeta | Marqeta |
| Receive and process raw settlement reports from the network | Marqeta | Marqeta |
| Deliver raw network settlement files to the customer’s SSH File Transfer Protocol (SFTP) / S3 location | Marqeta | Marqeta |
| Complete reconciliation of transactions | You | Marqeta |
| Fund a settlement account with correct amounts for the network | You | Marqeta |