Documentation Index

Fetch the complete documentation index at: https://www.documentation.paynetics.digital/llms.txt

Use this file to discover all available pages before exploring further.

Programs

Prev Next

A Program is the configuration object that governs the behaviour and capabilities of both accounts and the cards linked to them. Every account opened in the Paynetics platform is created under a specific Program — the Program code determines what the account can do, which currencies it holds, and what card types can be issued against it.

Programs are configured by Paynetics during onboarding, based on the agreed product specification. Program codes are provided to the partner at that stage. Partners cannot create or modify Programs via the API — changes must be requested through Paynetics.

You can operate multiple Programs within a single Instance to serve different customer segments or product lines. For example:

  • A consumer Program with EUR and GBP balances, IBANs enabled, virtual and physical cards

  • A corporate expense Program with EUR only, no IBAN, non-personalised physical cards, restricted merchant categories

  • A rewards Program with EUR only, virtual cards only, Apple Pay enabled

Each Program is independent. Accounts under different Programs share the same Instance but operate under their own rules.


Account Settings

Account settings define the behaviour of accounts and their balances created under this Program.

Currencies

Defines the set of currencies for which balances are created when an account is opened. If a Program has EUR and GBP configured, opening an account under that Program creates two balances — one in EUR, one in GBP.

Important: Accounts with multiple currency balances cannot have a card linked directly to them. Use a single-currency Program for accounts that need card issuance.

Generate IBAN

Defines whether an IBAN is automatically assigned to each currency balance at account creation. Configurable per currency. For GBP accounts, both an IBAN and a Sort Code + Account Number are assigned. IBANs are supported for EUR, GBP, and BGN only.

IBAN generation can be suppressed at the individual account level via an API flag at creation time, even when the Program has it enabled.

Generate Virtual Account IBANs

Similar to Generate IBAN, but applies to Virtual Accounts linked to accounts of this Program. Virtual Account IBAN configuration inherits the currency settings of the parent Payment Account — it cannot be configured independently per currency.

Consumer-Business Linking

Enables consumers to be linked to businesses, giving them authorised access to particular business accounts. A common use case is giving employees access to a business payment account for covering company expenses.


Card Settings

Card settings determine the default behaviour of cards issued against accounts of this Program.

General Card Settings

These are set at Program level and cannot be changed via the API after configuration:

Setting

Description

Non-personalised cards

Enables issuing of non-personalised cards

Virtual cards

Enables virtual card issuance

Physical cards

Enables physical card issuance

Apple Pay

Enables cards for Apple Pay push provisioning

Google Pay

Enables cards for Google Pay push provisioning

Note: Apple Pay and Google Pay enablement may require additional certification with card schemes. Apple Pay in particular may require lab certification.

Default Card Settings

These are applied by default to all cards in the Program but can be changed per card via the Card Limits and Groups API:

Setting

Description

Usage group

Defines permitted operations: ATM withdrawal, POS payment, online payment, cash advance

Authorisation fee group

Transaction fees such as ATM withdrawal fees

Recurring fee group

Recurring charges such as monthly card fees

Velocity limit group

Spending and withdrawal limits per operation type

MCC whitelist / blacklist

Allowed or blocked merchant category codes

Acceptor list

Whitelist of specific MIDs and TIDs for authorisation


Funds Loading

Cards can be funded through the following methods:

Internal transfers — Load from a Funding Account or any other Payment Account within the same Instance. Cards can also be loaded by customers initiating internal transfers, depending on Program configuration.

Inbound transfers — By receiving an inbound wire transfer to the IBAN or account number of the account linked to the card.

Card or account to card — Using Visa Direct or Mastercard Send to push funds directly from a card or account to another card.