1. Help Center
  2. Merchant Articles

General definitions

Agreements: The individual arrangements a Customer has with a Merchant, with specific amount(s) to be processed by Paypa Plane.

Invitation: The link sent to a Customer asking for permission to process the transactions via Paypa Plane for the agreed amount(s) and schedule. This contains all information relevant to the Agreement, including a digital DDR.
(i) Pending agreement: An agreement that has been sent to a Customer, who has not yet completed the on boarding process to begin making payments.
(ii) Agreements: Once an invitation has been accepted, agreed to and on boarded by a Customer, it becomes an Agreement.
(iii) Test Agreements: Agreements that have been sent as a test, with all identical functionality excluding real financial transactions being processed. This means all features of Paypa Plane will still be able to be performed, but no money will be transacted.
(iv) Archived agreements: Pending agreements that have been removed from the live environment.

Agreement structure: The setup/layout of an Agreement that is to be sent to a Customer.

Agreement status: This refers to the current state of a Customer specific agreement, once it is agreed to. These are;
(i) Active: The Customer has a live agreement with successfully processed transactions, and more scheduled in the future.
(ii) Cancelled: The agreement has been cancelled by the Merchant, and no further transactions will be processed for this agreement.

(iii) Complete: The agreement has come to an end with all transactions successfully processed (Applicable only to agreements with a defined finish date or amount).
(iv) Halted: An agreement that has all future scheduled transactions placed on hold for a period of time, meaning no money will be transacted/processed. Halts can be indefinite, or scheduled to resume after a predetermined period of time has passed.
(v) In care: This agreement is active, but a payment has been unsuccessful in an attempt. This state indicates the transaction is currently in Paypa Plane’s automatic retry sequence (using the unique Grace Period first, then auto retry if not resolved).
(vi) In recovery: An agreement that was suspended, but has been actioned by the Merchant to recoup the money owing. The suspended account has been re-activated, with the Customer agreeing to new or updated agreement terms.
(vii) Incomplete: The Customer has viewed the agreement, and confirmed that the information is correct, however they have NOT yet entered payment method details or signed the DDR.
(viii) Pending halt: An agreement that has a halt scheduled to take place on upcoming transaction(s).
(ix) Sent: The Customer has had no interaction with the agreement.

(x) Standing by: The Customer has confirmed details are correct, signed the DDR, entered their payment method details, however no transactions have taken place yet (but are scheduled in the future).
(xi) Suspended: The state an agreement is in after an unsuccessful transaction fails to be captured during the automatic process. Can only be resolved by a Merchant cancelling completely or booking a recovery.
(xii) Unsent: The agreement has not yet been sent to a Customer.

(xiii) Viewed: The Customer has clicked the link within the sms/email, and has viewed the agreement only.

Archive: The out of view storage of data that is no longer needed - specifically for Customers or agreements that a Merchant wishes to “delete”.


Auto retry: A transaction attempt instigated automatically by Paypa Plane two (2) days after a declined payment (provided it has not been successfully captured during the Grace Period). The number of these is determined by the Merchant, with a maximum of three (3).

Chargeback: A successful Customer dispute for a card transaction, resulting in a secure refund for a Customer purchase from a Merchant (initiated by the Customers issuing bank).


CSV: "Comma-Separated Values" - a simple file format used to store tabular data, such as a spreadsheet or database. Files in CSV format can be imported to and exported from programs that store data in tables, such as Microsoft Excel or OpenOffice Calc.

Customer: A person using the services of a professional. In this case, it refers to a person/user with an agreement to a Merchant/Business that Paypa Plane is processing payments for.
(i) Customers (label): Where all details and agreements are kept, viewed and edited.


DDR: Direct Debit Request - The authorisation form a Customer agrees to, allowing Paypa Plane (on behalf of a Merchant) to debit their account.


Declined transaction: A transaction that has been unsuccessful, due to a variety of reasons, as enforced by a bank (i.e. insufficient funds, lost/stolen card, credit card expired, etc.).


Direct entry: A transaction/payment method where the money is transferred from a bank account.

Fail code: The code/message that provides a reason that a transaction declined.


Grace Period™: A unique feature of Paypa Plane; a 24 hour window immediately following a declined payment, in which a Customer has the ability to successfully pay the amount owed without incurring a late fee. A nominal fee is charged to cover the declined payment.

Merchant: A person/company involved in selling goods/services. In this case, it refers to the Business holding a Paypa Plane account.

On boarding: The sequence a Customer goes through when accepting a payment request.

Recovery: The mechanism/tool within Paypa Plane used to recoup missed payments from an agreement that has been suspended.

Verified/Unverified payment method: Specific to Customers - If a Customer has not confirmed their bank account/credit card details through Paypa Plane’s verification process, they will be charged at a slightly higher unverified transaction rate. Once verified, they will pay the lower verified rate.

XLXS: A file extension for an open XML spreadsheet file format used by Microsoft Excel.