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.
State | Description |
---|---|
CREATED | The payment has been created and is pending approval. |
REJECTED | The payment has been rejected by the customer. |
APPROVED | The payment has been approved by the customer. |
PENDING_SUBMISSION | Atlar is submitting the payment to the bank. It cannot be edited at this point. |
SENT | The payment has been sent to the bank. |
PENDING_AT_BANK | The 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. |
ACCEPTED | The payment has been received and accepted by the bank. |
EXECUTED | The payment has been executed by the bank. |
FAILED | The payment has failed. |
RECONCILED | The payment has been reconciled to a transaction on your account statement. |
RETURNED | The payment has been returned by the bank. |
UNKNOWN | The 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.
State | Description |
---|---|
CREATED | The 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_SUBMISSION | Atlar is submitting the mandate to the bank. The mandate cannot be edited after this point. |
SENT | The mandate has been sent to the bank. |
ACCEPTED | The mandate has been received and accepted by the bank. |
ACTIVE | The mandate has been proven working with first reconciled collection, or was created with active=true flag. |
PENDING_CANCELLATION | You have issued a cancellation request. Atlar will submit the cancellation imminently. |
PENDING_CANCELLATION_SUBMISSION | Atlar is submitting the cancellation of the mandate to the bank. |
CANCELLATION_SENT | The cancellation of the mandate has been sent to the bank. |
FAILED | The mandate failed to register. This can either be a bank- or Atlar-side error. |
CANCELLED | The mandate has been cancelled, either by you or the counterparty. |
UNKNOWN | The 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 Type | Description | Additional Info |
---|---|---|
IBAN | International Bank Account Number | The 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. |
NUMBER | Bank specific account number | The 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_BANKGIRO | Swedish Bankgiro Number | The Bankgiro Number is a unique account number that consist of 7 or 8 digits and is used by the Swedish Bankgirot clearing system. |
SE_PLUSGIRO | Swedish PlusGiro Number | The 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 code | Market | IBAN | NUMBER | Routing | Comment |
---|---|---|---|---|---|
AT | Austria | 20 characters | 11 digit account number | 5 digits (AT_DLZ) | Use IBAN |
AU | Australia | - | 6-10 digit account number | 6 digits (AU_BSB) | |
BE | Belgium | 16 characters | - | ||
BG | Bulgaria | 22 characters | - | ||
CA | Canada | - | 7-12 digits account number | 9 digits (CA_CPA) | Routing consist of transit number and fin.instituion number. If given as 8 (5+3) digits, prepend 0 (zero). |
CH | Switzerland | 21 characters | Use IBAN | ||
CN | China | - | 14-19 digit account number | 12 digits (CN_APS) | |
CZ | Czech Republic | 24 characters | - | - | |
DE | Germany | 22 characters | 10 digit account number | 8 digits | Use IBAN |
DK | Denmark | 18 characters | 13 digit account number | - | |
ES | Spain | 24 characters | 12 digit account number | 8 digits | Use IBAN |
FI | Finland | 18 characters | - | - | |
FR | France | 27 characters | - | - | |
GB | United Kingdom | 22 characters | 8 digit account number | 6 digits (GB_DSC) | GB_DSC is most often referred to as Sort Code |
GH | Ghana | - | - | - | |
GR | Greece | 27 characters | 16 upper and lower case alphanumeric character account number | 7 digits | Use IBAN |
HR | Croatia | 21 characters | 10 digit account number | 7 digits | |
HU | Hungary | 28 characters | - | - | |
IE | Ireland | 22 characters | 8 digit account number | 6 digits | Use IBAN |
IT | Italy | 27 characters | c5n5n routing + 12c account number | c5n5n | Use IBAN |
IN | India | - | 10-20 digits | 11 digits | |
LT | Lithuania | 20 characters | - | - | |
LU | Luxembourg | 20 characters | - | - | |
NL | Netherlands | 18 characters | - | - | |
NO | Norway | 15 characters | - | - | |
PL | Poland | 28 characters | 16 digit account number | 8 digits (PL_KNR) | |
PT | Portugal | 25 characters | 13 digit account number | 8 digits | Use IBAN |
RO | Romania | 24 characters | - | - | |
SE | Sweden | 24 characters | 4-5 digit clearing number + 4-12 digit account number | e.g. ccccaaaaaaa where c is a clearing digit and a is an account number digit | |
SI | Slovenia | 19 characters | 10 digit account number | 5 digits | |
SK | Slovakia | 24 characters | - | - | |
US | United States | - | 6-17 digit account number | 9 digits (US_ABA) | |
VN | Vietnam | - | - | - |
Updated 8 months ago