When using Debitdirect, you will learn concepts about payments, mandates and agreements.

​
Agreements

An agreement is objective representation of a commercial agreement between you and Mastercard Payment Services. Any agreement provide you the ability to transact using direct debit schemes, and you must comply to the requirements before handling real payments. For the purpose of testing, Debitdirect provides the ability to add test agreements before moving to production.

Each agreement supported by its scheme, have different requirements. We will outline these under each scheme.

A agreement may have the following statuses:

  • Active. The agreement is active.
  • InActive. The agreement is either rejected or cancelled.
  • PendingActivation. The agreement was created but not activated yet.

​
Mandates

Mandates are digital contracts between you and one or more end-users. Mandates provides the required proof of authority between the end-users bank and your bank to transact between the parties.

Mandates are typically exchanged between Debitdirect as the data processor and Mastercard Payment Services.

​
Status of a mandate

A mandate may have the following statuses:

  • Active. The mandate is active and payment may be transacted towards the mandate.
  • Pending. The mandate is request and pending completion with either bank or Mastercard Payment Services. This status may be followed by Active or Rejected.
  • Cancelled. The mandate is cancelled due to expiration.
  • Revoked. The mandate is revoked either by You, the bank or the customer.
  • Rejected. The mandate cannot be registered.

​
Payments

A payment may have the following statuses:

  • Pending. This is the initial state. The payment has not yet been scheduled with the scheme.
  • Scheduled. The payment is scheduled and sent to the scheme.
  • Settled. The payment or refund is completed and money is on its way.
  • Rejected. Payment was rejected by debtor, creditor or bank.
  • PendingCancel. The payment was cancelled, pending confirmation from the scheme..
  • Cancelled. The payment is cancelled and will not be settled.
  • Chargeback. The payment or refund was reversed and rejected.