NAV Navbar
  • The Form3 Staging Environment
  • Transaction Simulator
  • Debug Endpoints
  • Upcoming Features
  • Staging Release Log
  • The Form3 Staging Environment

    Form3 Staging is a sandbox environment to try out the Form3 API, validate and debug your implementation.

    It closely resembles Form3's production environment, but isn't connected to any payment schemes. This means it doesn't support real-money transactions.

    Instead, the staging environment offers a transaction simulator that allows you to send and receive test transactions, as well as trigger a wide range of scenarios to make sure your client implementation handles them correctly.

    Addionally, the environment exposes debug endpoints to help you spot errors in your implementation.

    New features and changes to our services are deployed in the staging environment before being released into production. This gives you the chance to implement with new features and make sure your software is ready once an update reaches the production environment.

    Endpoint Connection

    The base URL for the staging environment is https://api.staging-form3.tech. Like with our production environment, you have to use TLS 1.2 or greater to connect to the API endpoints.

    Configuration

    Credentials

    Staging and production are two separate environments that require separate login information. This means that the login client ID and client secret that you use for the staging environment during implementation will not carry over to the production environment once you go live.

    Contact your Form3 implementation manager to acquire client credentials and set up your account on the staging environment.

    Organisation ID

    You will be issued an organisation ID when getting access to the staging environment. You can use the same organisation ID in staging and production, but different setups are also possible.

    User permissions

    When getting access to the staging environment, your organisation has one admin user with all possible permissions set up. You can create additional users with limited permissions if you prefer, see our tutorial on how to do that.

    Sort codes and BICs

    The staging environment performs sort code/BIC validation the same way the production environment does. This means that you will need a valid sort code or BIC to send payments in the staging environment.

    FPS Direct and Bacs

    Our sort code validation checks debtor and beneficiary sort codes on outbound payments against the Extended Industry Sorting Code Directory (EISCD). This mechanism ensures that you send payments to and from existing sort codes.

    For customers that already have one or several sort codes or BICs, we recommend you also use these in staging. Contact your implementation manager to have your codes configured in the staging environment.

    If you don't have a live sort code yet, your implementation manager can assign you a dummy sort code. Using that code, you can send payments to your own accounts that you have registered with our Account API, but not to accounts with other sort codes.

    FPS Indirect

    For new FPS Indirect customers, we will assign you a sort code to use with the FPS Indirect simulator. This codes may change in production as you go live.

    Validation API

    The Validation API allows you to check bank IDs and account number for validity. Currently only UK sort codes and account numbers are supported and checked against the EISCD.

    The EISCD file in the staging environment is frequently updated, however there can sometimes be a delay to propagate new sort codes to the staging environment.

    Transaction Simulator

    We provide simulators for all supported payment schemes. Talk to your Form3 contact about getting access to the scheme simulator for your intergration.

    FPS Indirect via Starling Simulator

    FPS Indirect uses the Starling FPS simulator. It offers a number of test accounts that will accept or reject payments sent to them. See the tables below for a list of available test accounts.

    The simulator allows you to send transactions between two accounts to test both the sending and receiving logic of your integration. This approach also supports returns.

    Outbound payments

    Accounts that will accept valid transactions:

    Account Number Sort Code
    00004588 203002
    00027944 203002
    58110244 204514
    60282377 204514
    99993193 166051
    87889196 166051

    Account that will reject transactions:

    Account Number Sort Code
    00004900 203002
    00028000 203002
    58110250 204514
    60282380 204514
    99993200 166051
    87889200 166051

    Different error codes can be triggered for rejected payments. Use the syntax rejectCode:nnnn in the reference attribute of the Payment resource, where nnnn represents the 4-digit scheme error code you want to trigger.

    If no error code is specified, 1114 – "Beneficiary Sort Code/Account Number unknown" will be used. Below is a list of supported error codes. Note that some error codes will trigger a automatic retry of the payment as a Future Dated Payment (FDP):

    Code Description Retried as FDP
    1100 Other No
    1114 Beneficiary Sort Code/Account Number unknown No
    1160 Beneficiary Account closed No
    1161 Beneficiary Account stopped No
    1162 Beneficiary Account Name does not match Beneficiary Account Number No
    1163 Account cannot be identified without data in Reference Information field No
    1164 Reference Information is incorrect No
    1167 Beneficiary deceased No
    1168 Fraudulent payment suspected No
    9909 Central Infrastructure System Malfunction Yes
    9910 Direct Receiver’s system not logged on Yes
    9911 Direct Receiver’s system timed out Yes
    9912 Direct Receiver’s system not available Yes
    9913 Duplicate FPID Yes

    Inbound payments

    For triggering inbound payments from accounts other than your own as well as to create a reversal for an inbound payment, ask your Form3 implementation manager.

    FPS Direct Simulator

    The FPS Direct simulator uses Form3's own simulator of the FPS scheme. It supports a large number of simulator scenarios that can be triggered by sending outbound payments with a certain amount. See the table below for a list of supported simulator scenarios.

    The simulator does not route payments. This means it does not support sending payment from one of your accounts to another one.

    The simulator resembles the actual FPS scheme as closely as possible, however, there are a few small differences:

    Supported Scenarios

    Trigger Amount Scenario
    13.00 Outbound payment will be accepted
    90.00 Outbound payment will be rejected
    99.10 Outbound payment will be accepted after being soft-rejected and retried by Form3 as a ForwardDatedPayment
    204.00 Outbound payment will be accepted, but with redirection of funds
    208.00 Outbound payment will be conditionally accepted
    216.16 Outbound payment will be rejected - unknown sortcode or account
    600.00 Outbound payment will be accepted and a separate inbound payment will be generated. Supports SIP, SOP, FDP payments via the scheme_payment_type field of the Payment resource.
    603.00 Outbound payment is accepted and a separate inbound POO payment is generated. There is a 50% chance an fx field is included in the Payment resource.
    640.00 Outbound payment will be accepted and a return will be generated for the outbound payment.
    855.00 Outbound payment is accepted, a separate inbound payment with amount 855.00 is generated and an inbound reversal is generated for that payment.
    1009.71 Generates an Unsolicited Message of type Service status change (USM-971)
    1009.72 Generates an Unsolicited Message of type FPS Institution and Third Party Beneficiary status change (USM-972)
    1009.73 Generates an Unsolicited Message of type Settlement Risk - Net Sender Threshold Status Change (USM-973)
    1009.74 Generates an Unsolicited Message of type Net Sender Cap Status (USM-974)
    1009.75 Generates an Unsolicited Message of type Settlement Individual Transaction Limit Change (USM-975)
    1009.76 Generates an Unsolicited Message of type Security Transaction Limit Change (USM-976)
    1009.77 Generates an Unsolicited Message of type Net Sender Threshold Change (USM-977)
    1009.78 Generates an Unsolicited Message of type Net Sender Cap Change (USM-978)
    1009.79 Generates an Unsolicited Message of type Settlement Status (USM-979)
    1009.80 Generates an Unsolicited Message of type Scheme Return Payment Failure (USM-980)
    1009.81 Generates an Unsolicited Message of type ASPM Alert Message (USM-981)

    Match Trigger Payments and Triggered Transactions

    To match trigger payments to triggered inbound transactions, use the reference field in the Payment resource of the trigger payment. Your reference will appear in the reference field of the inbound Payment resource that has been triggered as part of a scenario.

    Bacs Simulator

    The Bacs simulator uses Form3's own simulator of the Bacs scheme. It supports a large number of simulator scenarios that can be triggered by sending outbound payments with a certain amount. See the table below for a list of supported simulator scenarios.

    The simulator does not route payments. This means it does not support sending payment from one of your accounts to another one.

    Supported Scenarios

    Trigger Amount Scenario
    13.00 Outbound payment will be accepted
    600.00 Outbound payment will be accepted and a separate inbound payment will be generated.
    640.00 Outbound payment will be accepted and a return will be generated for the outbound payment
    700.00 Generates an inbound Direct Debit of type DirectDebitFirst
    700.01 Generates an inbound Direct Debit of type ClaimForUnpaidCheque
    750.00 Generates an inbound mandate of type DirectDebitInstructionNew
    751.00 Generates an inbound mandate of type DirectDebitInstructionCancel
    752.00 Generates an inbound mandate of type DirectDebitInstructionConvert
    854.03 Generates an inbound payment reversal
    854.05 Generates an outbound payment reversal
    2000.17 Generates a reversal of an inbound Direct Debit
    2000.18 Generates a reversal of an inbound Direct Debit of type ClaimForUnpaidCheque
    3000.17 Generates a reversal of an outbound Direct
    3000.18 Generates a reversal of an outbound Direct Debit of type ClaimForUnpaidCheque
    3000.19 Generates a reversal of an outbound Direct Debit of type AruddFirstCollection

    Bacs Cycle Time

    In the real world, Bacs uses a 3-day cycle to complete transactions: The transaction information is entered to the system on day 1, the transaction is processed on day 2 and the funds applied on day 3.

    The simulator attempts to model the behaviour of the real Bacs scheme as closely as possible. Transaction dates and restrictions around processing days are active. When receiving an inbound Bacs payment (by using the 600.00 scenario) on a Bacs working day, the scheme_processing_date of the Payment resource is set to the current date. For the inbound payment, this is Bacs day 2 - the same day Bacs provides you with information on inbound payments in the real world.

    Consequently, a Bacs return can only be processed on Bacs day 3 of the original payment. This means if you trigger an inbound payment and immediately return it, the return will only be processed on the next Bacs working day and the return submission will remain in queued_for_delivery state until then.

    Batching and File Submission

    Bacs is a batched service, meaning that all transactions are collected by Form3 and sent to Bacs on specific times on working days. In the simulator, this batching happens once every minute between 7am Monday and 7am Saturday UK time.

    Scenario Triggers

    The simulator reacts to trigger payments immediately. This means that when a trigger payment is submitted and processed, any inbound transactions are created immediately.

    Match Trigger Payments and Triggered Transactions

    To match trigger payments to triggered inbound transactions, use the reference field in the Payment resource of the trigger payment. Your reference will appear in the reference field of the inbound Payment, Direct Debit, Mandate, or Claim resource that has been triggered as part of a scenario.

    SEPA Instant & SCT Direct Simulator

    The SEPA Direct simulator uses Form3's own simulator of the SEPA Instant and Credit Transfer schemes and gateway. It supports a large number of simulator scenarios that can be triggered by sending outbound payments with a certain amount. See the table below for a list of supported simulator scenarios.

    The simulator does not route payments. This means it does not support sending payment from one of your accounts to another one.

    Supported Scenarios

    Trigger amount Scenario Schemes
    13.00 Outbound payment will be accepted SEPA Instant & SCT
    90.00 Outbound payment will be rejected.

    The scheme_status_code field of the Submission resource will be set to AC04 for SEPA Instant, to R23 for SCT.
    SEPA Instant & SCT
    99.31 Outbound payment will be rejected.

    The scheme_status_code field of the Submission resource will be populated from the end_to_end_reference field of the Payment resource.
    SEPA Instant
    300.00 Outbound payment will be accepted, sending an outbound recall for the payment will generate a positive inbound recall decision SEPA Instant & SCT
    310.00 Outbound payment will be accepted, a following outbound recall for the payment will be accepted, no recall decision is generated SEPA Instant & SCT
    391.00 Outbound payment will be accepted, a following outbound recall for the payment will generate a negative recall decision SEPA Instant & SCT
    400.00 Generates an inbound payment and recall for the payment, any decision can then be made against the recall SEPA Instant & SCT
    400.01 Generates an inbound payment and a recall for that payment, an outbound positive recall decision will be rejected and an inbound recall reversal is generated SEPA Instant & SCT
    600.00 Outbound payment will be accepted and a separate inbound payment will be generated SEPA Instant & SCT
    601.23 Outbound payment will be accepted and a separate inbound payment will be generated.

    The amount field of the inbound payment will be populated from the end_to_end_reference field of the Payment resource.
    SEPA Instant & SCT
    609.00 Outbound payment will be accepted and a separate inbound payment with amount 709.00 will be generated. SEPA Instant
    640.00 Outbound payment will be accepted and a return will be generated for the outbound payment SCT
    855.00 Outbound payment is accepted. A separate inbound payment and an inbound reversal for that payment are generated. The reversal arrives with a slight delay. SEPA Instant
    1009.51 Generates a Scheme Message of type Scheme participant unavailable SEPA Instant
    6000.00 Generates an inbound Pre-Settlement (PSR) Report. SCT
    6000.01 Generates an inbound Cycle Reconciliation (CRR) Report. SCT
    6000.02 Generates an inbound Daily Reconciliation (DRR) Report. SCT
    6000.03 Generates an inbound Monthly Statistical (MSR) Report. SCT
    6000.04 Generates an inbound Monthly Reconciliation NRR Report. SCT

    Match Trigger Payments and Triggered Transactions

    To match trigger payments to triggered inbound transactions, use the end_to_end_reference field in the Payment resource of the trigger payment. Your reference will appear in the end_to_end_reference field of the inbound Payment resource that has been triggered as part of a scenario.

    FPS and SEPA - LHV Indirect Simulator

    The LHV Indirect simulator emulates Form3's Indirect Participant propositions for FPS and SEPA Instant and Credit Transfer in the Staging Environment. It supports simulator scenarios for both account management and payments. See the below sections for a list of all supported scenarios for the Account API and Payment API.

    Account Management

    The LHV Indirect simulator supports scenarios for creating and deleting bank account using Form3's Account API. These scenarios are triggered by providing a specific country code in the private_identification.country field of the Account resource. The following scenarios are supported:

    Scenario Country Code Description
    Create Account Success GB, FR Create an Account resource with trigger country code
    Account is created successfully
    Account Events resources generated for status changes
    Final status is confirmed, final routing_status is routable
    Create Account Failure Any code except GB, FR Create an Account resource with trigger country code
    Account creation fails
    Account Event resources generated for status changes
    Final status is failed, final routing_status is unroutable
    Delete Account Success All country codes Delete an existing account
    Account is deleted successfully
    Account Event resources generated for status changes
    Final status is confirmed, final routing_status is deleted

    Supported Payment Scenarios

    Trigger Amount Scenario Supported Schemes
    13.00 Outbound payment will be accepted SEPA Instant, SCT, FPS
    40.00 Outbound payment will be accepted and payment_scheme field is updated to INTERNAL SEPA Instant, SCT, FPS
    90.00 Outbound payment will be rejected. status_reason is NARR - Insufficient funds available. SEPA Instant, SCT, FPS
    91.00 Outbound payment will be rejected. status_reason is NARR - Faulty sender account [] SEPA Instant, SCT, FPS
    600.00 Outbound payment will be accepted and a separate inbound payment will be generated SEPA Instant, SCT, FPS
    640.00 Outbound payment will be accepted and an inbound return is generated for the payment, return_code is MS02 SCT & FPS

    Match Trigger Payments and Triggered Transactions

    To match trigger payments to triggered inbound transactions, use the end_to_end_reference field in the Payment resource of the trigger payment. Your reference will appear in the end_to_end_reference field of the inbound Payment resource that has been triggered as part of a scenario.

    SEPA Direct Debit Indirect via GoCardless

    The SEPA Direct Debit Indirect simulator emulates Form3's SEPA Direct Debit Indirect proposition via GoCardless in the Staging Environment. It supports several simulator scenarios that can be triggered by sending outbound Direct Debits with a certain amount. See the table below for a list of supported simulator scenarios.

    Supported Scenarios

    Prerequisites for all scenarios:

    Trigger Amount Scenario Description
    Any except those mentioned below Direct Debit Submission Happy Path Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission succeeds, status delivery_confirmed.
    2. Mandate status active.
    3. Mandate Submission status delivery_confirmed.
    4. Inboud payment arrives, Payment Admission status confirmed.
    41.00 Direct Debit Submission Delivery Failed: GoCardless Validation Failure Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 41.00
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit fails
    2. Submission status is delivery_failed
    3. Submission status_reason is validation_failed: charge_date: must be on or after mandate's next_possible_customer_charge_date
    41.01 Direct Debit Submission Delivery Failed: Invalid State Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 41.01
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit fails
    2. Submission status is delivery_failed
    3. Submission status_reason is invalid_state: mandate is failed, cancelled or expired.
    42.00 Payment Return Submission Delivery Failed: GoCardless Validation Failure Steps:
    1. Create and submit a Mandate
    2. Create and submit Direct Debit resource with amount 42.00
    3. Receive Payment
    4. Create Return and Return Submission for Payment received in step 3. Use amount 42.00 in the Return.

    Outcome:
    1. Return fails
    2. Submission status is delivery_failed
    3. Submission status_reason is validation_failed
    42.01 Payment Return Submission Delivery Failed: Total Amount Confirmation Invalid Steps:
    1. Create and submit a Mandate
    2. Create and submit Direct Debit resource with amount 42.01
    3. Receive Payment
    4. Create Return and Return Submission for Payment received in step 3. Use amount 42.01 in the Return.

    Outcome:
    1. Return fails
    2. Submission status is delivery_failed
    3. Submission status_reason is invalid_state: total amount confirmation invalid.
    42.02 Payment Return Submission Delivery Failed: Number of Refunds Exceeded Steps:
    1. Create and submit a Mandate
    2. Create and submit Direct Debit resource with amount 42.02
    3. Receive Payment
    4. Create Return and Return Submission for Payment received in step 3. Use amount 42.02 in the Return.

    Outcome:
    1. Return fails
    2. Submission status is delivery_failed
    3. Submission status_reason is invalid_state: Number of refunds exceeded
    42.03 Payment Return Submission Delivery Failed: Access Denied Steps:
    1. Create and submit a Mandate
    2. Create and submit Direct Debit resource with amount 42.03
    3. Receive Payment
    4. Create Return and Return Submission for Payment received in step 3. Use amount 42.03 in the Return.

    Outcome:
    Return fails, submission status is delivery_failed, status_reason is "This endpoint is disabled for your creditor - please contact support"
    42.04 Payment Return Submission Delivery Failed: Refund Failed Steps:
    1. Create and submit a Mandate
    2. Create and submit Direct Debit resource with amount 42.04
    3. Receive Payment
    4. Create Return and Return Submission for Payment received in step 3. Use amount 42.04 in the Return.

    Outcome:
    1. Return fails
    2. Submission status is delivery_failed
    3. Submission status_reason is refund_failed
    52.00 Mandate Cancelled by Counterparty Steps:
    1. Create and submit a Mandate.
    2. Create Direct Debit resource with amount 52.00
    3. Create Direct Debit Submission resource

    Outcome:
    1. Mandate Admission is created for Mandate, status confirmed, status reason mandate_cancelled.
    2. Mandate is cancelled
    3. Mandate status cancelled
    Mandate scheme_payment_type is DirectDebitInstructionCancel.
    4. Mandate Submission remains with status released_to_gateway.
    62.00 Direct Debit Submission Delivery Failed: Authorisation Disputed Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.00
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is authorisation_disputed
    4. Direct Debit Submission scheme_status_code is authorisation_disputed
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate Submission status is delivery_failed.
    62.01 Direct Debit Submission Fails: Bank Account Closed Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.01
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit Submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is bank account closed
    4. Direct Debit Submissions scheme_status_code is bank_account_closed
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate Submission status is delivery_failed.
    62.02 Direct Debit Submission Delivery Failed: Bank Account Transferred Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.02
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is bank_account_transferred
    4. Direct Debit Submission scheme_status_code is bank_account_transferred
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate status is delivery_failed.
    62.03 Direct Debit Submission Delivery Failed: Not Enabled Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.03
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is account does not allow direct debit
    4. Direct Debit Submission scheme_status_code is direct_debit_not_enabled
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate status is delivery_failed.
    62.04 Direct Debit Submission Delivery Failed: Insufficient Funds Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.04
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is insufficient_funds
    4. Direct Debit Submission scheme_status_code is insufficient_funds
    5. Mandate is activated
    6. Mandate status is active.
    7. Mandate Submission succeeds
    8. Mandate status is delivery_confirmed.
    62.05 Direct Debit Submission Delivery Failed: Invalid Bank Details Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.05
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is invalid bank details
    4. Direct Debit Submission scheme_status_code is invalid_bank_details
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate status is delivery_failed.
    62.06 Direct Debit Submission Delivery Failed: Mandate Cancelled Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.06
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is mandate cancelled
    4. Direct Debit Submission scheme_status_code is mandate_cancelled
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate status is delivery_failed.
    62.07 Direct Debit Submission Delivery Failed: Mandate Expired Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.07
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is mandate expired
    4. Direct Debit Submission scheme_status_code is mandate_expired
    5. Mandate Admission is created for Mandate
    6. Mandate Admission status is confirmed
    7. Mandate Admission status_reason is mandate_cancelled.
    8. Mandate is cancelled
    9. Mandate status is cancelled
    10. Mandate scheme_payment_type is DirectDebitInstructionCancel.
    11. Mandate Submission status remains released_to_gateway.
    62.08 Direct Debit Submission Delivery Failed: Other Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.08
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is other
    4. Direct Debit Submission scheme_status_code is other
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate status is delivery_failed.
    62.09 Direct Debit Submission Delivery Failed: Refer to Payer Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.09
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is bank unable to pay
    4. Direct Debit Submission scheme_status_code is refer_to_payer
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate status is delivery_failed.
    62.10 Direct Debit Submission Delivery Failed: Test Failure Steps:
    1. Create and submit a Mandate
    2. Create Direct Debit resource with amount 62.10
    3. Create Direct Debit Submission resource

    Outcome:
    1. Direct Debit submission fails
    2. Direct Debit Submission status is delivery_failed
    3. Direct Debit Submission status_reason is test_failure
    4. Direct Debit Submission scheme_status_code is test_failure
    5. Mandate fails
    6. Mandate status is failed.
    7. Mandate Submission fails
    8. Mandate status is delivery_failed.

    Debug Endpoints

    Request signing

    The HTTP signature debug endpoint can be used to verify if a client is correctly signing HTTP requests. It returns validation messages that are not available in the production environment for security reasons.

    See our tutorial for more information on how to use the request signing debug endpoint.

    Upcoming Features

    This section contains information about upcoming changes and features that are available in our test environment but not yet in the production environment.

    Exception Flows for Recalls in SEPA Instant

    Form3 improves the handling of exception cases for inbound recalls and recall decisions in SEPA Instant. Specifically, Form3 will add API resources for the flows described below. These have previously been handled by Form3 without creating customer-visible API resources.

    This update is currently in development and will be released soon.

    The following flows are updated:

    Inbound Recall Arrives after Deadline

    If a recall for a previous payment arrives after the maximum time after which recalling a payment is allowed, Form3 automatically rejects the recall. In this case, a Recall resource and a Recall Admission resource are created, as well as a Recall Decision resource and a Recall Decision Submission resource.

    The answer field of the Recall Decision resource is set to rejected and the reason_code is NOAS. The auto field of the Recall Decision Submission is set to true to indicate the response has been created automatically.

    Inbound Recall Arrives for Unknown Payment

    If a recall arrives for a payment that is not present in the Form3 system, Form3 will create a placeholder Payment resource with all available information about the payment. No Payment Admission resource is created since the payment was never received by Form3.

    A Recall resource and Recall Admission resource are created for the recall and assigned to the placeholder payment. No automatic reply to the recall is created.

    Inbound Recall Arrives for Failed Payment

    If a recall arrives for a payment that was rejected by Form3 (the status field of the Payment Admission resource says failed), Form3 automatically rejects the recall. In this case, a Recall resource and a Recall Admission resource are created, as well as a Recall Decision resource and a Recall Decision Submission resource.

    The answer field of the Recall Decision resource is set to rejected and the reason_code is CUST. The auto field of the Recall Decision Submission is set to true to indicate the response has been created automatically.

    Staging Release Log

    This section contains a list of past updates to the staging environment. You can subscribe to updates on this release log using our Staging Releases RSS Feed.

    Note that the production environment has its own release log.

    Change types

    A change can be of the following types: breaking change, new feature, improvement and bug fix.

    See the table below for more information on the categories.

    Change Type Description
    Breaking Change This change requires customers to update their integration. These changes are very rare.
    New Feature Introduces a new feature or functionality.
    Improvement Improves an existing functionality.
    Bug Fix Fixes an existing functionality that was not working as expected.

    September 21, 2020

    IMPROVEMENTS

    September 17, 2020

    BUG FIXES

    September 14, 2020

    IMPROVEMENTS

    September 11, 2020

    IMPROVEMENTS

    September 10, 2020

    BUG FIXES

    September 9, 2020

    IMPROVEMENTS

    BUG FIXES

    September 4, 2020

    IMPROVEMENTS

    September 2, 2020

    IMPROVEMENTS

    BUG FIXES

    September 1, 2020

    BUG FIXES

    August 28, 2020

    IMPROVEMENTS

    August 27, 2020

    IMPROVEMENTS

    August 26, 2020

    IMPROVEMENTS

    August 25, 2020

    IMPROVEMENTS

    August 24, 2020

    BUG FIXES

    August 20, 2020

    IMPROVEMENTS

    BUG FIXES

    August 19, 2020

    IMPROVEMENTS

    August 18, 2020

    IMPROVEMENTS

    BUG FIXES

    August 17, 2020

    BUG FIXES

    August 14, 2020

    IMPROVEMENTS

    August 13, 2020

    NEW FEATURES

    IMPROVEMENTS

    August 12, 2020

    IMPROVEMENTS

    August 7, 2020

    IMPROVEMENTS

    August 6, 2020

    IMPROVEMENTS

    August 5, 2020

    IMPROVEMENTS

    August 3, 2020

    IMPROVEMENTS

    July 31, 2020

    NEW FEATURES

    IMPROVEMENTS

    July 30, 2020

    IMPROVEMENTS

    July 28, 2020

    IMPROVEMENTS

    July 27, 2020

    NEW FEATURES

    July 24, 2020

    NEW FEATURES

    IMPROVEMENTS

    July 23, 2020

    IMPROVEMENTS

    BUG FIXES

    July 22, 2020

    NEW FEATURES

    July 21, 2020

    IMPROVEMENTS

    July 20, 2020

    IMPROVEMENTS

    July 17, 2020

    IMPROVEMENTS

    July 16, 2020

    IMPROVEMENTS

    July 15, 2020

    IMPROVEMENTS

    July 9, 2020

    NEW FEATURES

    IMPROVEMENTS

    July 8, 2020

    NEW FEATURES

    July 7, 2020

    IMPROVEMENTS

    July 6, 2020

    NEW FEATURES

    June 26, 2020

    IMPROVEMENTS

    June 25, 2020

    IMPROVEMENTS

    June 23, 2020

    IMPROVEMENTS

    June 22, 2020

    IMPROVEMENTS

    BUG FIXES

    June 19, 2020

    IMPROVEMENTS

    June 18, 2020

    IMPROVEMENTS

    June 17, 2020

    IMPROVEMENTS

    June 16, 2020

    IMPROVEMENTS

    June 15, 2020

    IMPROVEMENTS

    June 12, 2020

    IMPROVEMENTS

    June 11, 2020

    IMPROVEMENTS

    June 10, 2020

    IMPROVEMENTS

    June 9, 2020

    IMPROVEMENTS

    June 8, 2020

    IMPROVEMENTS

    June 4, 2020

    IMPROVEMENTS

    June 2, 2020

    IMPROVEMENTS

    May 27, 2020

    IMPROVEMENTS

    May 22, 2020

    IMPROVEMENTS

    May 21, 2020

    NEW FEATURES

    May 19, 2020

    IMPROVEMENTS

    May 18, 2020

    IMPROVEMENTS

    May 15, 2020

    BUG FIXES

    May 14, 2020

    IMPROVEMENTS

    May 13, 2020

    IMPROVEMENTS

    May 12, 2020

    NEW FEATURES

    IMPROVEMENTS

    May 11, 2020

    NEW FEATURES

    May 7, 2020

    NEW FEATURES

    May 6, 2020

    NEW FEATURES

    May 4, 2020

    NEW FEATURES

    April 28, 2020

    NEW FEATURES

    IMPROVEMENTS

    April 22, 2020

    IMPROVEMENTS

    April 15, 2020

    NEW FEATURES

    IMPROVEMENTS

    April 3, 2020

    NEW FEATURES

    April 1, 2020

    IMPROVEMENTS

    March 31, 2020

    NEW FEATURES

    March 30, 2020

    NEW FEATURES

    March 27, 2020

    IMPROVEMENTS

    March 23, 2020

    NEW FEATURES

    March 19, 2020

    IMPROVEMENTS

    March 12, 2020

    IMPROVEMENTS

    March 5, 2020

    IMPROVEMENTS

    BUG FIXES

    March 4, 2020

    IMPROVEMENTS

    March 2, 2020

    NEW FEATURES

    February 28, 2020

    BUG FIXES

    February 27, 2020

    NEW FEATURES

    February 24, 2020

    NEW FEATURES

    February 21, 2020

    NEW FEATURES

    February 20, 2020

    IMPROVEMENTS

    February 18, 2020

    IMPROVEMENTS

    February 14, 2020

    BUG FIXES

    February 10, 2020

    BUG FIXES

    February 6, 2020

    IMPROVEMENTS

    February 5, 2020

    IMPROVEMENTS

    February 4, 2020

    IMPROVEMENTS

    February 3, 2020

    NEW FEATURES

    January 31, 2020

    IMPROVEMENTS

    January 23, 2020

    BUG FIXES

    January 22, 2020

    NEW FEATURES

    IMPROVEMENTS

    January 17, 2020

    BUG FIXES

    January 13, 2020

    BUG FIXES

    January 7, 2020

    IMPROVEMENTS

    January 6, 2020

    BUG FIXES

    December 31, 2019

    BUG FIXES

    December 17, 2019

    BUG FIXES

    December 13, 2019

    IMPROVEMENTS

    December 12, 2019

    IMPROVEMENTS

    December 10, 2019

    IMPROVEMENTS

    December 4, 2019

    NEW FEATURES

    December 3, 2019

    BUG FIXES

    November 14, 2019

    IMPROVEMENTS

    November 13, 2019

    NEW FEATURES

    November 12, 2019

    NEW FEATURES

    November 7, 2019

    NEW FEATURES

    October 30, 2019

    NEW FEATURES

    BUG FIXES

    October 29, 2019

    IMPROVEMENTS

    October 28, 2019

    IMPROVEMENTS

    October 25, 2019

    IMPROVEMENTS

    October 24, 2019

    IMPROVEMENTS

    October 21, 2019

    IMPROVEMENTS

    October 18, 2019

    IMPROVEMENTS

    October 14, 2019

    IMPROVEMENTS

    October 11, 2019

    IMPROVEMENTS

    October 9, 2019

    IMPROVEMENTS

    October 2, 2019

    BUG FIXES

    October 1, 2019

    IMPROVEMENTS

    September 24, 2019

    BUG FIXES

    September 23, 2019

    BUG FIXES

    September 20, 2019

    BUG FIXES

    September 19, 2019

    IMPROVEMENTS

    September 16, 2019

    BUG FIXES

    September 13, 2019

    BUG FIXES

    September 12, 2019

    NEW FEATURES

    September 9, 2019

    BUG FIXES

    September 7, 2019

    BUG FIXES

    September 3, 2019

    BUG FIXES

    August 30, 2019

    BUG FIXES

    August 28, 2019

    NEW FEATURES

    IMPROVEMENTS

    August 27, 2019

    NEW FEATURES

    August 22, 2019

    BUG FIXES

    August 21, 2019

    BUG FIXES

    August 20, 2019

    NEW FEATURES

    August 19, 2019

    NEW FEATURES

    August 16, 2019

    NEW FEATURES

    August 15, 2019

    NEW FEATURES

    IMPROVEMENTS

    August 14, 2019

    IMPROVEMENTS

    August 13, 2019

    IMPROVEMENTS

    August 9, 2019

    IMPROVEMENTS

    August 8, 2019

    BUG FIXES