Version 2.7.1 to 2.8.0

What's New

GET /issuers/{issuerId}/accounts/external-accounts/{issuerAccountExternalReference}/turnover-information

Retrieve turnover information for an account

The API is used to get the turnover information for an account

GET /issuers/{issuerId}/accounts/{accountReference}/turnover-information

Retrieve turnover information for an account

The API is used to get the turnover information for an account

GET /issuers/{issuerId}/companies/{customerReference}

Retrieve company's information

PUT /issuers/{issuerId}/companies/{customerReference}

Update company

The "update company" API allows the user to update the attributes of a customer. To identify the customer, it is needed to provide:

• The issuer ID
• The customer reference (internal or external) for which updates are required

The customer reference can be retrieved by using the "list customers" API. All the attributes must be given in input even if they remain unchanged. For that, It can be needed to use the "retrieve customer" API to get all the current attributes.

PATCH /issuers/{issuerId}/companies/{customerReference}

Update company partially

The "update company partially" API allows the user to update the attributes of a customer. To identify the customer, it is needed to provide:

• The issuer ID
• The customer reference (internal or external) for which updates are required

The customer reference can be retrieved by using the "List customers" API. With this API, only attributes that need to be updated must be given in input.

GET /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}

Retrieve company information by external reference

PUT /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}

Update Company

The "update Company" API allows the user to update the attributes of a customer. To identify the customer, it is needed to provide:

• The issuer ID
• The customer reference (internal or external) for which updates are required

The customer reference can be retrieved by using the "list customers" API. All the attributes must be given in input even if they remain unchanged. For that, It can be needed to use the "retrieve customer" API to get all the current attributes.

PATCH /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}

Update Company partially

The "update customer partially" API allows the user to update the attributes of a customer. To identify the customer, it is needed to provide:

• The issuer ID
• The customer reference (internal or external) for which updates are required

The customer reference can be retrieved by using the "List customers" API. With this API, only attributes that need to be updated must be given in input.

GET /issuers/{issuerId}/companies

Retrieve list of company's information

POST /issuers/{issuerId}/companies

Create company

GET /issuers/{issuerId}/companies/{customerReference}/addresses

Retrieve company's Address information list

POST /issuers/{issuerId}/companies/{customerReference}/addresses

Create address for a company customer

The API creates an address for the customer, identified with his reference. An address includes the following information:

• the issuer address external reference
• the label (eg MAIN_POSTAL_ADDRESS),
• the type (mail address, phone number, email) and the corresponding data
• the address usages
• the start date.

For information, the main postal address is mandatory.

In return, the API provides the address Reference calculated by our system.

GET /issuers/{issuerId}/companies/{customerReference}/addresses/{addressReference}

Retrieve company's address information by address ref

PUT /issuers/{issuerId}/companies/{customerReference}/addresses/{addressReference}

Update company address

The API updates all the attributes of a customer's address identified with the reference of the customer and the reference of the address. All the attributes must be provided even those unchanged. The identifiers stay unchanged.

GET /issuers/{issuerId}/companies/{customerReference}/addresses/external-addresses/{issuerAddressExternalReference}

Retrieve company's address information by externalAddress

PUT /issuers/{issuerId}/companies/{customerReference}/addresses/external-addresses/{issuerAddressExternalReference}

Update company address

The API updates all the attributes of a customer's address identified with the reference of the customer and the reference of the address. All the attributes must be provided even those unchanged. The identifiers stay unchanged.

GET /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses

Retrieve company's Address information list by external reference

POST /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses

Create address for a company

The API creates an address for the customer, identified with his reference. An address includes the following information:

• the issuer address external reference
• the label (eg MAIN_POSTAL_ADDRESS),
• the type (mail address, phone number, email) and the corresponding data
• the address usages
• the start date.

For information, the main postal address is mandatory.

In return, the API provides the address Reference calculated by our system.

GET /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/{addressReference}

Retrieve address information by company external reference and address reference

PUT /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/{addressReference}

Update company address

The API updates all the attributes of a customer's address identified with the reference of the customer and the reference of the address. All the attributes must be provided even those unchanged. The identifiers stay unchanged.

GET /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/external-addresses/{issuerAddressExternalReference}

Retrieve address information by company external reference and address external reference

PUT /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/external-addresses/{issuerAddressExternalReference}

Update company address

The API updates all the attributes of a customer's address identified with the reference of the customer and the reference of the address. All the attributes must be provided even those unchanged. The identifiers stay unchanged.

POST /issuers/{issuerId}/companies/{customerReference}/addresses/{addressReference}/activate

Activate address of a company

POST /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/{addressReference}/activate

Activate address of a company

POST /issuers/{issuerId}/companies/{customerReference}/addresses/external-addresses/{issuerAddressExternalReference}/activate

Activate address of a company

POST /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/external-addresses/{issuerAddressExternalReference}/activate

Activate address of a company

POST /issuers/{issuerId}/companies/{customerReference}/addresses/{addressReference}/deactivate

Deactivate address of a company

POST /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/{addressReference}/deactivate

Deactivate address of a company

POST /issuers/{issuerId}/companies/{customerReference}/addresses/external-addresses/{issuerAddressExternalReference}/deactivate

Deactivate address of a company

POST /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/external-addresses/{issuerAddressExternalReference}/deactivate

Deactivate address of a company

POST /issuers/{issuerId}/companies/{customerReference}/addresses/{addressReference}/address-usages

Create an address usage for a company

This API allows to link a usage determined by its name (e.g. STATEMENT_SENDING), its entity reference (e.g. card contract reference) and its service code (e.g. ACCOUNT_SERVICE) and the address (identified with its internal reference) of a company (identified with its external reference).

DELETE /issuers/{issuerId}/companies/{customerReference}/addresses/{addressReference}/address-usages

Remove an address usage of a company

The API deletes the address usages linked to one address. These address usages are filtered by the request params : addressUsageName (for definition see the ressource addressUsage), mandatory entityReference (for definition see the ressource addressUsage), optional serviceCode (for definition see the ressource addressUsage), mandatory If the entityReference is empty and the API finds several addresseUsages (for the addressUsageName and serviceCode in request param), then the list of addressUsages will be deleted.

POST /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/{addressReference}/address-usages

Create an address usage for a company

The address usage describes for which business case the address will be used (e.g., statement sending, card delivery, ...). The complete authorized values list is shared during the product configuration between the issuer and WL. This API allows a usage determined by its name (e.g. STATEMENT_SENDING) to be linked to the entity reference of the address (e.g. card contract reference) and the service code (e.g. ACCOUNT_SERVICE)

DELETE /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/{addressReference}/address-usages

Remove an address usage of a company

The API deletes the address usages linked to one address. These address usages are filtered by the request params : addressUsageName (for definition see the ressource addressUsage), mandatory entityReference (for definition see the ressource addressUsage), optional serviceCode (for definition see the ressource addressUsage), mandatory If the entityReference is empty and the API finds several addresseUsages (for the addressUsageName and serviceCode in request param), then the list of addressUsages will be deleted.

POST /issuers/{issuerId}/companies/{customerReference}/addresses/external-addresses/{issuerAddressExternalReference}/address-usages

Create an address usage for a company

The address usage describes for which business case the address will be used (e.g., statement sending, card delivery, ...). The complete authorized values list is shared during the product configuration between the issuer and WL. This API allows a usage determined by its name (e.g. STATEMENT_SENDING) to be linked to the entity reference of the address (e.g. card contract reference) and the service code (e.g. ACCOUNT_SERVICE)

DELETE /issuers/{issuerId}/companies/{customerReference}/addresses/external-addresses/{issuerAddressExternalReference}/address-usages

Remove an address usage of a company

The API deletes the address usages linked to one address. These address usages are filtered by the request params : addressUsageName (for definition see the ressource addressUsage), mandatory entityReference (for definition see the ressource addressUsage), optional serviceCode (for definition see the ressource addressUsage), mandatory If the entityReference is empty and the API finds several addresseUsages (for the addressUsageName and serviceCode in request param), then the list of addressUsages will be deleted.

POST /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/external-addresses/{issuerAddressExternalReference}/address-usages

Create an address usage for a company

This API allows to link a usage determined by its name (e.g. STATEMENT_SENDING), its entity reference (e.g. card contract reference) and its service code (e.g. ACCOUNT_SERVICE) and the address (identified with its external reference) of a company (identified with its external reference).

DELETE /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/addresses/external-addresses/{issuerAddressExternalReference}/address-usages

Remove an address usage of a company

The API deletes the address usages linked to one address. These address usages are filtered by the request params : addressUsageName (for definition see the ressource addressUsage), mandatory entityReference (for definition see the ressource addressUsage), optional serviceCode (for definition see the ressource addressUsage), mandatory If the entityReference is empty and the API finds several addresseUsages (for the addressUsageName and serviceCode in request param), then the list of addressUsages will be deleted.

GET /issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/{accountReference}

Retrieve corporate employee Accounts

This API allows retrieving a particular corporate employee accounts from its reference or its issuer external reference

PATCH /issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/{accountReference}

Update Corporate employee account

The API allows to update a corporate Employee account

GET /issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}

Retrieve corporate employee Accounts With External Account Ref

This API allows retrieving a particular corporate employee accounts from its reference or its issuer external reference

PATCH /issuers/{issuerId}/corporate-contracts/{contractReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}

Update Corporate employee account by external account

The API allows to update a corporate Employee account

GET /issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}

Retrieve corporate employee Accounts With External Contract Ref And External Account Ref

This API allows retrieving a particular corporate employee accounts from its reference or its issuer external reference

PATCH /issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/external-accounts/{issuerAccountExternalReference}

Update Corporate employee account by external contract and account

The API allows to update a corporate Employee account

GET /issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/{accountReference}

Retrieve corporate employee Accounts With External Contract Ref

This API allows retrieving a particular corporate employee accounts from its reference or its issuer external reference

PATCH /issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/corporate-employee-accounts/{accountReference}

Update Corporate employee account By external contract

The API allows to update a corporate Employee account

GET /issuers/{issuerId}/companies/{customerReference}/corporate-contracts

List corporate contracts for a company

The API returns all the corporate contracts where the company belongs to

GET /issuers/{issuerId}/companies/external-customers/{issuerCustomerExternalReference}/corporate-contracts

List corporate contracts for a company

The API returns all the corporate contracts where the company belongs to

GET /issuers/{issuerId}/corporate-contracts/{contractReference}

Retrieve corporate contract

This API allows retrieving a particular corporate contract from its reference or its issuer external reference. The API response contains contract information such as:

• contract identifier with the contract reference and the issuer external contract reference if previously provided
• product change information if any, such as its current status (scheduled, done, cancelled), new product, new contract if it exists
• embedded fields if requested such as list of all customers or identifiers linked to this contract (e.g. contract owner, root account owner, cardholder(s)), card contracts, cards

POST /issuers/{issuerId}/corporate-contracts/{contractReference}/close

Close Corporate contract

The API allows to close a corporate contract identified by the Contract reference. The contract can be closed immediately or in the future at a date provided by the issuer or at the card expiry date.

As result, For immediate closure : The contract is closed, the cards within the contract are deactivated, the closing is triggered for the accounts.

For scheduled closure : The contract is not changed until the closing date is reached. Once the closing date is reached, the contract is closed, the cards within the contract are deactivated, the closing is triggered for the accounts.

POST /issuers/{issuerId}/corporate-contracts/external-contracts/{issuerContractExternalReference}/close

Close Corporate contract

The API allows to close a Corporate contract identified by the Issuer Contract external reference or the Contract reference. The contract can be closed immediately or in the future at a date provided by the issuer or at the card expiry date.

As result, For immediate closure : The contract is closed, the cards within the contract are deactivated, the closing is triggered for the accounts.

For scheduled closure : The contract is not changed until the closing date is reached. Once the closing date is reached, the contract is closed, the cards within the contract are deactivated, the closing is triggered for the accounts.

POST /issuers/{issuerId}/cards/declare-counterfeit-card

Declare counterfeit card

What's Changed

POST /issuers/{issuerId}/cards/pin-state

Response:

• Changed property data (object CardStates)
  • Added property expiryDate (string)
  • Added property status (string)
  • Added property blockingReason (string)

POST /issuers/{issuerId}/contracts/{contractReference}/force-product-change

Response:

• Changed property data (object ForceProductChangeResponse)
  • Added property originalContract (object)
  • Added property changedContract (object)
  • Added property productChangeInformation (object)
  • Deleted property oldContract (object)
  • Deleted property newContract (object)

POST /issuers/{issuerId}/contracts/external-contracts/{issuerContractExternalReference}/force-product-change

Response:

• Changed property data (object ForceProductChangeResponse)
  • Added property originalContract (object)
  • Added property changedContract (object)
  • Added property productChangeInformation (object)
  • Deleted property oldContract (object)
  • Deleted property newContract (object)

GET /issuers/{issuerId}/cards/external-cards/{issuerCardExternalReference}

Response:

• Changed property data (object Card)
  • Added property logoReference (string)
  • Added property dispatchCode (string)
  • Added property automaticDeactivationDate (string)
  • Deleted property replacementForAutomaticDeactivationDate (string)
  • Changed property cardContract (object CardContract)
    • Changed property cards (array)
      • Changed items (object Card)
        • Added property logoReference (string)
        • Added property dispatchCode (string)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/cards/external-cards/{issuerCardExternalReference}/block-and-replace

Request body:

• Changed property replaceCardRequest (object ReplaceCardRequest)
  • Added property forceNewPIN (boolean)

Response:

• Changed property data (object BlockAndReplaceCardResponse)
  • Changed property replaceCardResponse (object ReplaceCardResponse)
    • Added property originalContract (object)
    • Added property changedContract (object)
    • Added property productChangeInformation (object)
    • Changed property card (object ReplaceCardResponse.Card)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)
    • Changed property newRelatedCardList (array)
      • Changed items (object ReplaceCardResponse)
        • Added property originalContract (object)
        • Added property changedContract (object)
        • Added property productChangeInformation (object)
        • Changed property card (object ReplaceCardResponse.Card)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/cards/external-cards/{issuerCardExternalReference}/orders/{orderReference}

Response:

• Changed property data (object Order)
  • Changed property card (object Card)
    • Added property logoReference (string)
    • Added property dispatchCode (string)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)
    • Changed property cardContract (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/cards/external-cards/{issuerCardExternalReference}/replace

Request body:

• Added property forceNewPIN (boolean)

Response:

• Changed property data (object ReplaceCardResponse)
  • Added property originalContract (object)
  • Added property changedContract (object)
  • Added property productChangeInformation (object)
  • Changed property card (object ReplaceCardResponse.Card)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)
  • Changed property newRelatedCardList (array)
    • Changed items (object ReplaceCardResponse)
      • Added property originalContract (object)
      • Added property changedContract (object)
      • Added property productChangeInformation (object)
      • Changed property card (object ReplaceCardResponse.Card)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/cards/{cardReference}

Response:

• Changed property data (object Card)
  • Added property logoReference (string)
  • Added property dispatchCode (string)
  • Added property automaticDeactivationDate (string)
  • Deleted property replacementForAutomaticDeactivationDate (string)
  • Changed property cardContract (object CardContract)
    • Changed property cards (array)
      • Changed items (object Card)
        • Added property logoReference (string)
        • Added property dispatchCode (string)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/cards/{cardReference}/block-and-replace

Request body:

• Changed property replaceCardRequest (object ReplaceCardRequest)
  • Added property forceNewPIN (boolean)

Response:

• Changed property data (object BlockAndReplaceCardResponse)
  • Changed property replaceCardResponse (object ReplaceCardResponse)
    • Added property originalContract (object)
    • Added property changedContract (object)
    • Added property productChangeInformation (object)
    • Changed property card (object ReplaceCardResponse.Card)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)
    • Changed property newRelatedCardList (array)
      • Changed items (object ReplaceCardResponse)
        • Added property originalContract (object)
        • Added property changedContract (object)
        • Added property productChangeInformation (object)
        • Changed property card (object ReplaceCardResponse.Card)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/cards/{cardReference}/orders/{orderReference}

Response:

• Changed property data (object Order)
  • Changed property card (object Card)
    • Added property logoReference (string)
    • Added property dispatchCode (string)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)
    • Changed property cardContract (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/cards/{cardReference}/replace

Request body:

• Added property forceNewPIN (boolean)

Response:

• Changed property data (object ReplaceCardResponse)
  • Added property originalContract (object)
  • Added property changedContract (object)
  • Added property productChangeInformation (object)
  • Changed property card (object ReplaceCardResponse.Card)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)
  • Changed property newRelatedCardList (array)
    • Changed items (object ReplaceCardResponse)
      • Added property originalContract (object)
      • Added property changedContract (object)
      • Added property productChangeInformation (object)
      • Changed property card (object ReplaceCardResponse.Card)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/contracts/{contractReference}/change-product

Response:

• Changed property data (object ChangeProductResponse)
  • Added property originalContract (object)
  • Added property changedContract (object)
  • Added property productChangeInformation (object)
  • Deleted property oldContract (object)
  • Deleted property newContract (object)

POST /issuers/{issuerId}/contracts/external-contracts/{issuerContractExternalReference}/change-product

Response:

• Changed property data (object ChangeProductResponse)
  • Added property originalContract (object)
  • Added property changedContract (object)
  • Added property productChangeInformation (object)
  • Deleted property oldContract (object)
  • Deleted property newContract (object)

GET /issuers/{issuerId}/credit-transfers/{endToEndId}

Response:

• Changed property data (object CreditTransfer)
  • Added property cancellationDate (string)

GET /issuers/{issuerId}/direct-debits/{endToEndId}

Response:

• Changed property data (object DirectDebit)
  • Added property cancellationDate (string)

GET /issuers/{issuerId}/accounts/external-accounts/{issuerAccountExternalReference}

Response:

• Changed property data (object Account)
  • Added property companyEntityExternalReference (string)
  • Deleted property companyAccountExternalReference (string)

GET /issuers/{issuerId}/accounts/external-accounts/{issuerAccountExternalReference}/authorizations/{authorizationId}

Response:

• Changed property data (object GetAuthorizationResponse)
  • Changed property velocityLimitChecks (array)
    • Changed items (object VelocityLimitCheck)
      • Deleted property name (string)

GET /issuers/{issuerId}/accounts/external-accounts/{issuerAccountExternalReference}/credit-transfers

Response:

• Changed property data (array)
  • Changed items (object CreditTransfer)
    • Added property cancellationDate (string)

GET /issuers/{issuerId}/accounts/external-accounts/{issuerAccountExternalReference}/direct-debits

Response:

• Changed property data (array)
  • Changed items (object DirectDebit)
    • Added property cancellationDate (string)

GET /issuers/{issuerId}/accounts/{accountReference}

Response:

• Changed property data (object Account)
  • Added property companyEntityExternalReference (string)
  • Deleted property companyAccountExternalReference (string)

GET /issuers/{issuerId}/accounts/{accountReference}/authorizations/{authorizationId}

Response:

• Changed property data (object GetAuthorizationResponse)
  • Changed property velocityLimitChecks (array)
    • Changed items (object VelocityLimitCheck)
      • Deleted property name (string)

GET /issuers/{issuerId}/accounts/{accountReference}/credit-transfers

Response:

• Changed property data (array)
  • Changed items (object CreditTransfer)
    • Added property cancellationDate (string)

GET /issuers/{issuerId}/accounts/{accountReference}/direct-debits

Response:

• Changed property data (array)
  • Changed items (object DirectDebit)
    • Added property cancellationDate (string)

GET /issuers/{issuerId}/card-contracts/external-card-contracts/{issuerCardContractExternalReference}

Response:

• Changed property data (object CardContract)
  • Changed property cards (array)
    • Changed items (object Card)
      • Added property logoReference (string)
      • Added property dispatchCode (string)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/card-contracts/external-card-contracts/{issuerCardContractExternalReference}/cards

Response:

• Changed property data (array)
  • Changed items (object Card)
    • Added property logoReference (string)
    • Added property dispatchCode (string)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/card-contracts/{cardContractReference}

Response:

• Changed property data (object CardContract)
  • Changed property cards (array)
    • Changed items (object Card)
      • Added property logoReference (string)
      • Added property dispatchCode (string)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/card-contracts/{cardContractReference}/cards

Response:

• Changed property data (array)
  • Changed items (object Card)
    • Added property logoReference (string)
    • Added property dispatchCode (string)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/cards/external-cards/{issuerCardExternalReference}/card-contract

Response:

• Changed property data (object CardContract)
  • Changed property cards (array)
    • Changed items (object Card)
      • Added property logoReference (string)
      • Added property dispatchCode (string)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/cards/external-cards/{issuerCardExternalReference}/orders

Response:

• Changed property data (array)
  • Changed items (object Order)
    • Changed property card (object Card)
      • Added property logoReference (string)
      • Added property dispatchCode (string)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)
      • Changed property cardContract (object CardContract)
        • Changed property cards (array)
          • Changed items (object Card)
            • Added property logoReference (string)
            • Added property dispatchCode (string)
            • Added property automaticDeactivationDate (string)
            • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/cards/search

Response:

• Changed property data (array)
  • Changed items (object Card)
    • Added property logoReference (string)
    • Added property dispatchCode (string)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/cards/{cardReference}/card-contract

Response:

• Changed property data (object CardContract)
  • Changed property cards (array)
    • Changed items (object Card)
      • Added property logoReference (string)
      • Added property dispatchCode (string)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/cards/{cardReference}/orders

Response:

• Changed property data (array)
  • Changed items (object Order)
    • Changed property card (object Card)
      • Added property logoReference (string)
      • Added property dispatchCode (string)
      • Added property automaticDeactivationDate (string)
      • Deleted property replacementForAutomaticDeactivationDate (string)
      • Changed property cardContract (object CardContract)
        • Changed property cards (array)
          • Changed items (object Card)
            • Added property logoReference (string)
            • Added property dispatchCode (string)
            • Added property automaticDeactivationDate (string)
            • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/cards/update-all-blocking-information

Response:

• Changed property data (array)
  • Changed items (object Card)
    • Added property logoReference (string)
    • Added property dispatchCode (string)
    • Added property automaticDeactivationDate (string)
    • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/accounts/external-accounts/{issuerAccountExternalReference}/authorizations

Response:

• Changed property data (array)
  • Changed items (object Authorization)
    • Changed property velocityLimitChecks (array)
      • Changed items (object VelocityLimitCheck)
        • Deleted property name (string)

GET /issuers/{issuerId}/accounts/external-accounts/{issuerAccountExternalReference}/contract

Response:

• Changed property data (object Contract)
  • Added property contractClosedByProductChange (object)
  • Added property contractCreatedFromProductChange (object)
  • Deleted property productChangeInformation (object)
  • Changed property accounts (array)
    • Changed items (object Account)
      • Added property companyEntityExternalReference (string)
      • Deleted property companyAccountExternalReference (string)
  • Changed property cardContracts (array)
    • Changed items (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/accounts/{accountReference}/authorizations

Response:

• Changed property data (array)
  • Changed items (object Authorization)
    • Changed property velocityLimitChecks (array)
      • Changed items (object VelocityLimitCheck)
        • Deleted property name (string)

GET /issuers/{issuerId}/accounts/{accountReference}/contract

Response:

• Changed property data (object Contract)
  • Added property contractClosedByProductChange (object)
  • Added property contractCreatedFromProductChange (object)
  • Deleted property productChangeInformation (object)
  • Changed property accounts (array)
    • Changed items (object Account)
      • Added property companyEntityExternalReference (string)
      • Deleted property companyAccountExternalReference (string)
  • Changed property cardContracts (array)
    • Changed items (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/card-contracts/external-card-contracts/{issuerCardContractExternalReference}/contract

Response:

• Changed property data (object Contract)
  • Added property contractClosedByProductChange (object)
  • Added property contractCreatedFromProductChange (object)
  • Deleted property productChangeInformation (object)
  • Changed property accounts (array)
    • Changed items (object Account)
      • Added property companyEntityExternalReference (string)
      • Deleted property companyAccountExternalReference (string)
  • Changed property cardContracts (array)
    • Changed items (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/card-contracts/{cardContractReference}/contract

Response:

• Changed property data (object Contract)
  • Added property contractClosedByProductChange (object)
  • Added property contractCreatedFromProductChange (object)
  • Deleted property productChangeInformation (object)
  • Changed property accounts (array)
    • Changed items (object Account)
      • Added property companyEntityExternalReference (string)
      • Deleted property companyAccountExternalReference (string)
  • Changed property cardContracts (array)
    • Changed items (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/contracts/{contractReference}/sign

Response:

• Changed property data (object SignContractResponse)
  • Changed property contract (object SignContractResponse.Contract)

    • New optional properties:

      • contractOwnerIdentifier
      • creationDate
      • productIdentifier

    • Deleted property creationDate (string)

    • Deleted property signatureDate (string)

    • Deleted property issuerBranchCode (string)

    • Deleted property cardReleaseOrder (string)

    • Deleted property productIdentifier (object)

    • Deleted property contractOwnerIdentifier (object)

    • Changed property accounts (array)

      • Changed items (object SignContractResponse.Account)

        • New optional properties:

          • accountGuarantorIdentifier
          • accountOwnerIdentifier

        • Deleted property accountOwnerIdentifier (object)

        • Deleted property accountGuarantorIdentifier (object)

    • Changed property cardContracts (array)

      • Changed items (object SignContractResponse.CardContract)

        • New required properties:

          • cardContractIdentifier
          • cards
          • status

        • New optional properties:

          • principalSupplementaryCardIndicator
          • relatedAccounts

        • Added property cards (array)

        • Deleted property cardHolderIdentifier (object)

        • Deleted property principalSupplementaryCardIndicator (string)

        • Deleted property card (object)

        • Deleted property relatedAccounts (array)

        • Deleted property externalCobadgedCardNumber (string)

        • Deleted property externalCobadgedSequenceNumber (string)

        • Deleted property externalCobadgedExpiryDate (string)

POST /issuers/{issuerId}/contracts/external-contracts/{issuerContractExternalReference}/sign

Response:

• Changed property data (object SignContractResponse)
  • Changed property contract (object SignContractResponse.Contract)

    • New optional properties:

      • contractOwnerIdentifier
      • creationDate
      • productIdentifier

    • Deleted property creationDate (string)

    • Deleted property signatureDate (string)

    • Deleted property issuerBranchCode (string)

    • Deleted property cardReleaseOrder (string)

    • Deleted property productIdentifier (object)

    • Deleted property contractOwnerIdentifier (object)

    • Changed property accounts (array)

      • Changed items (object SignContractResponse.Account)

        • New optional properties:

          • accountGuarantorIdentifier
          • accountOwnerIdentifier

        • Deleted property accountOwnerIdentifier (object)

        • Deleted property accountGuarantorIdentifier (object)

    • Changed property cardContracts (array)

      • Changed items (object SignContractResponse.CardContract)

        • New required properties:

          • cardContractIdentifier
          • cards
          • status

        • New optional properties:

          • principalSupplementaryCardIndicator
          • relatedAccounts

        • Added property cards (array)

        • Deleted property cardHolderIdentifier (object)

        • Deleted property principalSupplementaryCardIndicator (string)

        • Deleted property card (object)

        • Deleted property relatedAccounts (array)

        • Deleted property externalCobadgedCardNumber (string)

        • Deleted property externalCobadgedSequenceNumber (string)

        • Deleted property externalCobadgedExpiryDate (string)

GET /issuers/{issuerId}/contracts/external-contracts/{issuerContractExternalReference}

Response:

• Changed property data (object Contract)
  • Added property contractClosedByProductChange (object)
  • Added property contractCreatedFromProductChange (object)
  • Deleted property productChangeInformation (object)
  • Changed property accounts (array)
    • Changed items (object Account)
      • Added property companyEntityExternalReference (string)
      • Deleted property companyAccountExternalReference (string)
  • Changed property cardContracts (array)
    • Changed items (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/contracts/external-contracts/{issuerContractExternalReference}/accounts

Response:

• Changed property data (array)
  • Changed items (object Account)
    • Added property companyEntityExternalReference (string)
    • Deleted property companyAccountExternalReference (string)

GET /issuers/{issuerId}/contracts/external-contracts/{issuerContractExternalReference}/card-contracts

Response:

• Changed property data (array)
  • Changed items (object CardContract)
    • Changed property cards (array)
      • Changed items (object Card)
        • Added property logoReference (string)
        • Added property dispatchCode (string)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/contracts/{contractReference}

Response:

• Changed property data (object Contract)
  • Added property contractClosedByProductChange (object)
  • Added property contractCreatedFromProductChange (object)
  • Deleted property productChangeInformation (object)
  • Changed property accounts (array)
    • Changed items (object Account)
      • Added property companyEntityExternalReference (string)
      • Deleted property companyAccountExternalReference (string)
  • Changed property cardContracts (array)
    • Changed items (object CardContract)
      • Changed property cards (array)
        • Changed items (object Card)
          • Added property logoReference (string)
          • Added property dispatchCode (string)
          • Added property automaticDeactivationDate (string)
          • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/contracts/{contractReference}/accounts

Response:

• Changed property data (array)
  • Changed items (object Account)
    • Added property companyEntityExternalReference (string)
    • Deleted property companyAccountExternalReference (string)

GET /issuers/{issuerId}/contracts/{contractReference}/card-contracts

Response:

• Changed property data (array)
  • Changed items (object CardContract)
    • Changed property cards (array)
      • Changed items (object Card)
        • Added property logoReference (string)
        • Added property dispatchCode (string)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/customers/external-customers/{issuerCustomerExternalReference}/accounts

Response:

• Changed property data (array)
  • Changed items (object Account)
    • Added property companyEntityExternalReference (string)
    • Deleted property companyAccountExternalReference (string)

GET /issuers/{issuerId}/customers/external-customers/{issuerCustomerExternalReference}/card-contracts

Response:

• Changed property data (array)
  • Changed items (object CardContract)
    • Changed property cards (array)
      • Changed items (object Card)
        • Added property logoReference (string)
        • Added property dispatchCode (string)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/customers/{customerReference}/accounts

Response:

• Changed property data (array)
  • Changed items (object Account)
    • Added property companyEntityExternalReference (string)
    • Deleted property companyAccountExternalReference (string)

GET /issuers/{issuerId}/customers/{customerReference}/card-contracts

Response:

• Changed property data (array)
  • Changed items (object CardContract)
    • Changed property cards (array)
      • Changed items (object Card)
        • Added property logoReference (string)
        • Added property dispatchCode (string)
        • Added property automaticDeactivationDate (string)
        • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/contracts/search

Response:

• Changed property data (array)
  • Changed items (object Contract)
    • Added property contractClosedByProductChange (object)
    • Added property contractCreatedFromProductChange (object)
    • Deleted property productChangeInformation (object)
    • Changed property accounts (array)
      • Changed items (object Account)
        • Added property companyEntityExternalReference (string)
        • Deleted property companyAccountExternalReference (string)
    • Changed property cardContracts (array)
      • Changed items (object CardContract)
        • Changed property cards (array)
          • Changed items (object Card)
            • Added property logoReference (string)
            • Added property dispatchCode (string)
            • Added property automaticDeactivationDate (string)
            • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/customers/external-customers/{issuerCustomerExternalReference}/contracts

Response:

• Changed property data (array)
  • Changed items (object Contract)
    • Added property contractClosedByProductChange (object)
    • Added property contractCreatedFromProductChange (object)
    • Deleted property productChangeInformation (object)
    • Changed property accounts (array)
      • Changed items (object Account)
        • Added property companyEntityExternalReference (string)
        • Deleted property companyAccountExternalReference (string)
    • Changed property cardContracts (array)
      • Changed items (object CardContract)
        • Changed property cards (array)
          • Changed items (object Card)
            • Added property logoReference (string)
            • Added property dispatchCode (string)
            • Added property automaticDeactivationDate (string)
            • Deleted property replacementForAutomaticDeactivationDate (string)

GET /issuers/{issuerId}/customers/{customerReference}/contracts

Response:

• Changed property data (array)
  • Changed items (object Contract)
    • Added property contractClosedByProductChange (object)
    • Added property contractCreatedFromProductChange (object)
    • Deleted property productChangeInformation (object)
    • Changed property accounts (array)
      • Changed items (object Account)
        • Added property companyEntityExternalReference (string)
        • Deleted property companyAccountExternalReference (string)
    • Changed property cardContracts (array)
      • Changed items (object CardContract)
        • Changed property cards (array)
          • Changed items (object Card)
            • Added property logoReference (string)
            • Added property dispatchCode (string)
            • Added property automaticDeactivationDate (string)
            • Deleted property replacementForAutomaticDeactivationDate (string)

POST /issuers/{issuerId}/contracts/create-consumer-contract

Request body:

• Changed property addCardsAccounts (object CreateConsumerContractRequest.AddCardsAccounts)
  • Changed property cardContracts (array)
    • Changed items (object CreateConsumerContractRequest.CardContract)
      • Added property techAndAppModelReference (string)
• Changed property contract (object CreateConsumerContractRequest.Contract)
  • Changed property cardContracts (array)
    • Changed items (object CreateConsumerContractRequest.CardContract)
      • Added property techAndAppModelReference (string)

Response:

• Changed property data (object CreateConsumerContractResponse)
  • Changed property contract (object CreateConsumerContractResponse.Contract)
    • Changed property cardContracts (array)
      • Changed items (object CreateConsumerContractResponse.CardContract)
        • Added property originalCardContractIdentifier (object)
        • Added property changedCardContractIdentifier (object)

POST /issuers/{issuerId}/contracts/external-contracts/{issuerContractExternalReference}/add-cards-accounts

Request body:

• Changed property cardContracts (array)
  • Changed items (object CreateConsumerContractRequest.CardContract)
    • Added property techAndAppModelReference (string)

Response:

• Changed property data (object AddCardsAccountsResponse)
  • Changed property contract (object CreateConsumerContractResponse.Contract)
    • Changed property cardContracts (array)
      • Changed items (object CreateConsumerContractResponse.CardContract)
        • Added property originalCardContractIdentifier (object)
        • Added property changedCardContractIdentifier (object)

POST /issuers/{issuerId}/contracts/{contractReference}/add-cards-accounts

Request body:

• Changed property cardContracts (array)
  • Changed items (object CreateConsumerContractRequest.CardContract)
    • Added property techAndAppModelReference (string)

Response:

• Changed property data (object AddCardsAccountsResponse)
  • Changed property contract (object CreateConsumerContractResponse.Contract)
    • Changed property cardContracts (array)
      • Changed items (object CreateConsumerContractResponse.CardContract)
        • Added property originalCardContractIdentifier (object)
        • Added property changedCardContractIdentifier (object)

Step – 1 : Get the reach details :

Reach details provides list of APIs needs to be used for this scenario and mandatory fields needs to be passed for successful API call towards ASPSP mock.

Call the reach API – GET /aspsp. Get the ASPSP details with Name = “Payment Redirect” and the ASPSP ID = “20100”, which has to be used to initiate the payment with redirect mode of authorisation and other further payment related requests.

Remark : Details of reach information provided in developer portal are limited and informational purpose to give initiating party (user) an idea about how reach information looks like. Initiating party (user) can skip this step and use specified ASPSP ID for the scenario to try out.

Step – 2 : Initiate the payment :

Call the POST /payments API with mandatory fields in request header and body. In response of POST /payments, initiating party (user) will receive payment ID, ASPSP redirect link to authorise the initiated payment and link to call GET /payments/status API to get the status of the initiated payment.

If GET /payments/status endpoint has been called before user provides his / her approval, initiating party (user) will receive payment status = “Open” from the ASPSP Mock in response.

Step – 3 : Authorise or Cancel the payment at ASPSP Mock :

With ASPSP redirect link received in response of POST /payments, customer (PSU) will get redirect to ASPSP Mock GUI login page. On this login page, customer (user) can provide dummy credential details as this is example purpose only. Once customer (PSU) provides his / her dummy credentials, he / she will be redirected to ASPSP Mock GUI page with “Approve” & “Deny” buttons to authorise or cancel the payment.

If customer (PSU) “Approve” the payment, payment will get initiated with the ASPSP Mock and customer (PSU) will redirect back to initiating party (user).

If customer (PSU) “Deny” the payment, ASPSP Mock will reject the initiated payment and customer (PSU) will redirect back to initiating party (user).

Remark : GUI page of ASPSP Mock to approve or deny the payment is just a demo purpose. Actual ASPSP GUI page to approve or deny the payment may vary based on ASPSP.

Step – 4 : Get the payment status :

Call the GET /payments/status API to get the latest payment status from ASPSP Mock.

If payment is authorised by customer (PSU), initiating party (user) will receive payment status = “Settlement Completed” as final payment status.

If payment is deny by customer (PSU), initiating party (user) will receive payment status = “Cancelled” as final payment status.

Remark : Payment status provided for this scenario is just to guide initiating party (user) for payment initiation process. Actual payment status may vary based on scenario from actual ASPSP.

Sequence Diagram :

Below you'll find a list of Payment Initiation Service (PIS) scenarios. Each scenario includes a separate page including a step by step description of the steps to complete the scenario. You can choose a scenario by providing the corresponding ASPSP ID in the request, which initiates the payment.

To simplify the interaction, these scenario's work with a static token which doesn't expire. This sandbox token is supplied in the API reference.

You can use the sandbox:

• On the API reference page (only for registered users, look for the 'try' button)

• With a tool like Postman

These pages describe the components from the Open Banking API version 3 which are used to initiate an iDEAL 2.0 payment. Some sections are based on the iDEAL 2.0 implementation guide from Currence, the iDEAL scheme holder.

Terminology

The terminology used in this document is based on the Payment Service Directive 2.

Open Banking API features for iDEAL payments

Standard iDEAL payments:

• Payment without profile recognition enables PSUs to pay with iDEAL without the need of a registered profile, by means of a manual bank selection or QR code, offered on an iDEAL payment page. See: sequence diagram: example of a flow without profile recognition. On the Transaction Flow page.
• Prefill preferred bank and IBAN for iDEAL payments: The PSU's iDEAL profile can be recognized by using the PsuId which the Open Banking Service can match to iDEAL debtor token, this allows the Initiating Party to immediately present the PSU with his preferred IBAN, and redirect the PSU to his preferred ASPSP (with preferred IBAN pre-selected). Upon future visits, the Initiating Party can retrieve and/or make use of the PSU’s payment preferences in the iDEAL transaction. See: sequence diagram: example of a flow with profile recognition. On the Transaction Flow page.

Fast Checkout iDEAL payment:

• Prefill address and contact details for iDEAL payments: The iDEAL Fast Checkout function allows the PSU to share his centrally stored address and contact details with Initiating Party upon request. This means that PSUs, for example, do not have to enter their address details each time they shop at a different Initiating Party. See: sequence diagram: Fast Checkout. On the Transaction Flow page.

Ecosystem Overview

The Open Banking Services, marked in green, is provided by Worldline

.

Payment processing consists of several main steps, visible in the diagram and explained in dedicated chapters:

1. Payment Preparation

2. Payment Initiation

3. Payment Authorisation

4. Payment Execution

Worldline prepared a set of functions supporting these steps (the white boxes in the diagram). Each of those functions have a page with more explanation. You can choose how to integrate:

• Using Worldline Open Banking functions directly. This allows you to control the user experience, but will require more integration effort due to various combinations of payment flows.

• Using ready-to-go components (Bank Selection Interface and Push Notification). This will provide you with a streamlined integration due to a set of (white labeled) screens which support Bank selection and guides users through the payment steps and push notifications that you will receive whenever payment status changes.

Both integration options can also be combined.

Once you finished your implementation we recommend to go through the list of suggested testing scenarios

The Bank Selection Interface includes customizable screens for payers to select their bank and complete any necessary authorization steps. Simply set the field UseAuthorisationLandingPages= true in the Payment Initiation Request to use this feature. It makes integration easier and streamlines the payment process. These are the typical steps to carry out a payment:

Typical Steps

Step 1: Choose bank and provide necessary information   After clicking the "Pay " button, payers can select their bank from the supported options.  We display icons for popular banks, group related banks, and allow for free searching by bank name to simplify the process. In certain cases, customers may need to provide additional information, like their IBAN, which Worldline manages without any extra integration needed. If a bank's ID is provided in the Post Payments API, the bank will be automatically prefilled.
Step 2: Accept Terms and Conditions    After selecting the bank, customers are directed to the summary page, where they can review all payment details.  Here they can conveniently agree to terms and conditions by simply checking a box.  Once done, they can proceed to the next steps by clicking the "Pay" button.  If you are using your own PSD2 license, we can easily customize the links in the summary page to lead to your specific terms and conditions.
Step 3: Authenticate and Authorize the Payment   During this step, the payer needs to authenticate themselves with their bank and approve payment execution to the bank.  The following example illustrates what the bank's payment authorization process may look like.
Step 4: Check Payment Status to follow on Payment Execution   After the payer authorizes the payment, they will be redirected back to the Bank Selection Interface.  At this point, the Bank Selection Interface will verify the status of the payment and display it to the payer.  Then the payer can be redirected back to your software to complete the purchase journey.  The following example demonstrates a potential screen layout after a successful payment.

Customization

You can personalize almost all elements to align with your brand - from the left bar to the title and all buttons.  Customizing these elements enhances brand recognition and presents a professional appearance for your users.  The following example showcases a payment summary page with customized branding.

Example scenarios

Below you can interact with a few example scenarios. The interactivity is limited, but it gives a good impression of the screen flow a payer will face when using the Bank Selection Interface (a live demo is also available here). It showcases the difference between the desktop and mobile user interface and the difference in flow when the payment preferences are saved (the payer check-marked 'Pay faster next time'), in a previous payment.

Implementation

To initiate a payment using the Bank Selection Interface the following functions should be implemented: Retrieve Token (An API to retrieve a token which is used in the subsequent API requests) Single Payment (An API to initiate a single payment, use 'UseAuthorisationLandingPages=true' in the Header) Payment Status (An API to request the status of a payment) or Push Notification (an API which allows you to receive requests when a payment status update occurs)   The diagram on the right shows the typical payment flow using Bank Selection Interface. You can click on the image to enlarge it.

Example: Post payments API request which redirects to Bank Selection Interface

curl --location --request POST 'https://xs2a-int.awltest.de/xs2a/routingservice/services/ob/pis/v3/payments' \
                --header 'X-Request-ID: 6e16f87f-08b1-460e-972d-21b824f07113' \
                --header 'Content-Type: application/json' \
                --header 'Authorization: Bearer ### Fill token here ###' \
                --header 'MessageId: d1efddaf-ea94-4c37-9b57-18640bd422a4' \
                --header 'MessageCreateDateTime: 2020-11-13T03:49:45.784Z' \
                --header 'UseAuthorisationLandingPages: true' \
                --data-raw '{
                    "PaymentProduct": [
                        "PSD2-SCT"
                    ],
                    "CommonPaymentData": {
                        "EndToEndId": "EndtoEndId",
                        "InitiatingPartyReferenceId": "### unique value ###",
                        "Amount": {
                            "Amount": "238.00",
                            "Currency": "EUR"
                        },
                        "RemittanceInformation": "Order #322551"
                    }
                }'

The Open Banking Section of the Developer Portal gives you all information you need to follow the steps from Onboarding to Go Live.
If you want to check out our available APIs, please browse our API Catalogue.

What is Open Banking? 

Open Banking facilitates secure connectivity between banks, Third Party Providers (TPPs) and their clients. TPPs can access financial data or initiate payments from their customers’ banks via APIs after the customer grants access. Here is an overview on the Roles of the participating parties: 

Open Banking APIs could be used for various purposes, such as Accounting Automation, Cash Management, Credit Scoring Decisions, personal Finance Management etc. You can learn more about Worldline Open Banking Products in section Open Banking Products.

To implement Open Banking Products you will need to check the Payments and Account Data sections.

What are the Steps from Onboarding to Go Live?

Switch to Implementation Steps in order to obtain more information on the typical implementation steps.

Glossary

Some Open Banking specific expressions sound unfamiliar to you? Please access our Glossary.

Need any help?

Do not hesitate to contact us in case you have any queries related to technical implementation or you would like to receive a quotation.