Step 4: Running seller marketplace operations

For each creditor, the system follows the configured rules to determine the days to pay the merchant after a sale, the number of installments, rates and fees to discount and pay the marketplace, other fees, and balance impacts as debits or credits.

Use Create creditor operation to configure your rules. This rules configuration defines the operations used when a merchant transaction occurs and you set them up during onboarding.

Enable merchant transactions (payments on schedule with creditor operations)

Transactions that compose the receivables schedule usually originate from sales payments received or sales cancellations (reversal transactions). Merchant transactions aim to pay merchants and marketplaces based on the schedule and creditor operations configured.

You can use the following endpoints to request payment authorizations or list merchant transactions.

Display receivables schedule

A receivables schedule provides a list of transactions with scheduled dates to pay merchants, advance receivables scheduled for the future, rates, and fees, summarized daily for a given merchant. View this schedule with the List merchant transactions (V2) endpoints or using a calendar interface.

Receivables schedule calendar

Figure 1: Receivables schedule calendar

Configure receivables advancement

Merchants might need to advance receivables scheduled for a future date. This means that even if the payment schedule is for 10 days later, the merchant can still request to receive the payment immediately. The system discounts an additional rate from the scheduled amount, and transfers the net amount to the creditor account either immediately or when the settlement process occurs. You use Simulate Merchant Advancement to create an advancement schedule and apply discount rate.

Understand transaction settlement

A scheduled batch job settles transactions on a given date. When the service executes this batch job, the marketplace system settles the transactions scheduled for the current date, meaning a cash-in occurs in the account related to the creditor, transferring the net amount after discounts of rates and fees as per creditor operations configuration. Refer to How merchant settlements are processed for more details about how settlement works.

What's next? Test your seller marketplace.