Payment Details

Payment statuses

Use the below diagram for guidance of how Payments (credit-transfers as well as direct-debits) transitions through various statuses.

❗️

It is NOT recommended to have clients strictly locked down as the diagram below shows.

The state machine is to be used as guidance and for understandability of how Atlar Payments behave, not as a strict truth to what always will occur.

Atlar may create new events (not statuses), and hence new transitions in the below state diagram without considering it breaking backwards compatibility. Statuses will however not change.

There are also situations where unexpected issues occur (can be because of bank or Atlar), and in those situations an Atlar operator can force update a payments status to get back into the correct status. This will result in an event: OPERATOR_FORCE_UPDATE, and the updated entity will have the new status.

StateDescription
CREATEDThe payment has been created and is pending approval.
REJECTEDThe payment has been rejected by the customer.
APPROVEDThe payment has been approved by the customer.
PENDING_SUBMISSIONAtlar is submitting the payment to the bank. It cannot be edited at this point.
SENTThe payment has been sent to the bank.
PENDING_AT_BANKThe payment is stuck in a pending state at the bank. It can for instance be related to insufficient funds or if bank-side signature has been configured.
ACCEPTEDThe payment has been received and accepted by the bank.
EXECUTEDThe payment has been executed by the bank.
FAILEDThe payment has failed.
RECONCILEDThe payment has been reconciled to a transaction on your account statement.
RETURNEDThe payment has been returned by the bank.
UNKNOWNThe payment's status is unknown.

(Direct-Debit) Mandate statuses

Use the below diagram for guidance of how Mandates transitions through various states. While we would consider changing the possible state transitions a non-backwards compatible change of the API, it is not recommended to have clients strictly locked down as the diagram shows.

StateDescription
CREATEDThe mandate is created (with active=false). How this mandate is sent to the bank will depend on the scheme. E.g. AUTOGIRO mandates are sent directly while SDD ones are sent along-side first payment.
PENDING_SUBMISSIONAtlar is submitting the mandate to the bank. The mandate cannot be edited after this point.
SENTThe mandate has been sent to the bank.
ACCEPTEDThe mandate has been received and accepted by the bank.
ACTIVEThe mandate has been proven working with first reconciled collection, or was created with active=true flag.
PENDING_CANCELLATIONYou have issued a cancellation request. Atlar will submit the cancellation imminently.
PENDING_CANCELLATION_SUBMISSIONAtlar is submitting the cancellation of the mandate to the bank.
CANCELLATION_SENTThe cancellation of the mandate has been sent to the bank.
FAILEDThe mandate failed to register. This can either be a bank- or Atlar-side error.
CANCELLEDThe mandate has been cancelled, either by you or the counterparty.
UNKNOWNThe mandate's status is unknown.

Payment schemes and Timings

Payment timings differ across schemes; this section provides you with a general overview. However, it’s important to note that there are differences between banks in how they handle timings — we cover this during your onboarding to your respective banks.

SEPA

SEPA Credit Transfer

SEPA Credit Transfers reach the recipient account within one business day. In case a payment has been sent prior to the underlying bank’s cut-off time, the payment will be settled the same day. In case the payment was sent after the cutoff it will reach the recipient within one business day.

SEPA Instant Credit Transfer

SEPA Instant Credit Transfers are processed instantly 24/7/365. In most cases, the money is available to the recipient within 10 seconds after the payment has been sent.

SEPA Direct Debit CORE

Collections can be made straight away when a mandate has been signed with the customer. For the majority of banks, the direct debit collection instruction must be sent to the bank at least one business day prior to the requested collection date.

SEPA Direct Debit B2B

Collections can be made after the debtor bank has validated the existence of the mandate. It has to be noted that the creditor will not receive a notification regarding the mandate activation status. Thus, it has to be tested by initiating a direct debit collection. For the majority of banks, the direct debit collection instruction must be sent to the bank at least one business day prior to the requested collection date.

Sweden

Swedish account transfer

Swedish account-to-account transfers reach the recipient account within one business day. In case a payment has been sent prior to the underlying bank’s cut-off time, the payment will be settled same-day. In case the payment was sent after the cutoff it will reach the recipient within one business day.

Swedish giro payment

Swedish Giro – BankGiro & PlusGiro – payments reach the recipient account within 1 business day. In case a payment has been sent prior to the underlying bank’s cut-off time, the payment will be settled the same day. In case the payment was sent after the cutoff it will reach the recipient within 1 business day.

Autogiro

New mandates can take up to 6 business days before they’re activated and collections can be made. Collection instructions must be sent to the bank at least 1 business day prior to the requested collection date.

Denmark

Danish account transfers

Standard Credit Transfers

Standard Credit Transfers will arrive the following business day if the payment was sent to the bank prior to the cut-off. In case the payment order is sent after the cut-off, the payment will reach the recipient’s account two business days after it is sent.

Same-day Credit Transfers

Same-day credit transfers reach the recipient’s account the same day if the payment order was sent to the bank prior to the cut-off. In case the payment order is sent after the cut-off, the payment will reach the recipient’s account one business day after it is sent.

Immediate Credit Transfers

Immediate credit transfers are processed instantly 24/7/365 can be used for payments up to DKK 500,000. The money is made available to the recipient within seconds after the payment order is sent by the debtor.

Betalingsservice

Mandates will be registered by next business day if sent to MasterCard prior to 5:30pm CET. Collections can be made one business day after a mandate has been registered. The deadline for submissions to Betalingsservice is 9am CET six working days before the end of the month preceding the month in which you wish to take the payment. Example: You wish to collect in September, so you need to send a payment request to Betalingsservice 6 working days before the end of August.

International

Cross-border bank transfers

Cross-border bank transfers are financial transactions where the debtor and creditor are based in separate countries or when the debtor and creditor are in the same market but transacting in a third currency. In the case of SEPA countries, a transaction would classify as cross-border if the currency transacted in is not the Euro. For example, a Swedish company with a Danish currency account initiates a payment to a company based in Denmark with a Danish bank account.

Cross-border payments are sent through the SWIFT (System for Worldwide Interbank Financial Telecommunications) messaging system and leverage the concept of correspondent banking to settle the funds. As cross-border payments are sent over SWIFT, they require an IBAN and a BIC to identify the recipient account.

The amount of time it takes for a cross-border payment usually ranges from one to five days. If the payment has been initiated prior to the cut-off time, it will be processed the same day.

Account Identifiers

Account identifiers differ across markets. This section provides you with a general overview of the four types of account identifiers used by Atlar.

Account Identifier TypeDescriptionAdditional Info
IBANInternational Bank Account NumberThe International Bank Account Number (IBAN) is a unique account identifier that contains all necessary information of a bank account. The number contains a two letter country code, bank and branch information and the account number. There is no uniform length for the IBAN but the maximum length is 34 characters.

Not all countries use IBANs.
NUMBERBank specific account numberThe bank specific Account Number is a unique account number at a bank without any bank identifier (e.g. routing or clearing number). Each country and bank can have their own account number standards but the number is mostly numeric and in some cases alphanumeric.

It's important to understand and that different countries have different information in this type of Account Identifier. For instance, a British (GB) NUMBER should be 8 digits (referred domestically as account number), whereas a Swedish (SE) NUMBER should be 8 to 17 digits, including both (what domestically is referred to as) clearing number and account number.

In order to specify a, for instance, British so-called sort code, one uses Routing Identifiers. The SWIFT code, or BIC identifier is also considered a Routing Identifier.

If the country supports IBANs, an IBAN identifier is superior to NUMBER when it comes to payment scheme availability and payment success rate.
SE_BANKGIROSwedish Bankgiro NumberThe Bankgiro Number is a unique account number that consist of 7 or 8 digits and is used by the Swedish Bankgirot clearing system.
SE_PLUSGIROSwedish PlusGiro NumberThe PlusGiro Number is also a unique account number used in Sweden by the PlusGirot clearing system. The number consists of 2 to 8 digits.

Country specific account identifiers

Atlar performs validation on country specific account identifiers. This table provides you with more details.

Market codeMarketIBANNUMBERRoutingComment
ATAustria20 characters11 digit account number5 digits (AT_DLZ)Use IBAN
AUAustralia-6-10 digit account number6 digits (AU_BSB)
BEBelgium16 characters-
BGBulgaria22 characters-
CACanada-7-12 digits account number9 digits (CA_CPA)Routing consist of transit number and fin.instituion number. If given as 8 (5+3) digits, prepend 0 (zero).
CHSwitzerland21 charactersUse IBAN
CNChina-14-19 digit account number12 digits (CN_APS)
CZCzech Republic24 characters--
DEGermany22 characters10 digit account number8 digitsUse IBAN
DKDenmark18 characters13 digit account number-
ESSpain24 characters12 digit account number8 digitsUse IBAN
FIFinland18 characters--
FRFrance27 characters--
GBUnited Kingdom22 characters8 digit account number6 digits (GB_DSC)GB_DSC is most often referred to as Sort Code
GHGhana---
GRGreece27 characters16 upper and lower case alphanumeric character account number7 digitsUse IBAN
HRCroatia21 characters10 digit account number7 digits
HUHungary28 characters--
IEIreland22 characters8 digit account number6 digitsUse IBAN
ITItaly27 charactersc5n5n routing + 12c account numberc5n5nUse IBAN
INIndia-10-20 digits11 digits
LTLithuania20 characters--
LULuxembourg20 characters--
NLNetherlands18 characters--
NONorway15 characters--
PLPoland28 characters16 digit account number8 digits (PL_KNR)
PTPortugal25 characters13 digit account number8 digitsUse IBAN
RORomania24 characters--
SESweden24 characters4-5 digit clearing number + 4-12 digit account numbere.g. ccccaaaaaaa
where c is a clearing digit and a is an account number digit
SISlovenia19 characters10 digit account number5 digits
SKSlovakia24 characters--
USUnited States-6-17 digit account number9 digits (US_ABA)
VNVietnam---