EPC Directory Service (EDS) API

Previous page Embed Token Sandbox API Reference

The EPC is an international non-profit association (AISBL), located in Brussels, Belgium. Its members are Payment Service Providers (PSP) or national or European PSP associations. The EPC payment-related schemes developed by the EPC – SPAA, SRTP and VOP – mandate the use of APIs for the exchange of data and for payment transaction initiation. To learn more about this API, see EPC Directory Service (EDS) API Overview. In this section, you will find information on how to integrate, test and go live with EPC Directory Service (EDS) API.

OpenAPI specification and technical specifications

Refer to the EPC Directory Service (EDS) VOP API Reference or EPC Directory Service (EDS) SRTP API Reference and the Technical Specification on the EPC website to help you integrate with the EPC Directory Service.

Info

If you are interested in using the automated download service where you can download EDS files in various formats through an API call, refer to Technical Specification for onboarding and integration information.

Test EPC Directory Service (EDS) APIs in the Sandbox

We recommend that you test your integration with EPC Directory Service (EDS) APIs in the sandbox before going Live. The EPC Directory Service (EDS) API sandbox behaves the same as the live environment, and you can use it to fully test your application. Follow the steps below to start testing in the API sandbox.

Test EPC Directory Service (EDS) API VOP

Caution

Access to EDS API sandbox is exclusive to Verification of Payee (VOP) scheme participants who have completed the documental adherence process.

1Complete the VOP scheme adherence process. Click here for more information.

2Create an app and select EPC Directory Service (EDS) API VOP.

3Use dedicated sandbox credentials for authentication in the API sandbox.

4Click the Run in Postman button below to view, fork or download the postman collection which includes authentication API calls and sample EPC Directory Service (EDS) API calls.

5Refer to postman collection guide to configure variables.

Test EPC Directory Service (EDS) API SRTP

Caution

Access to EDS API sandbox is exclusive to SEPA Request-to-pay (SRTP) scheme participants who have completed the documental adherence process.

1Complete the SRTP scheme adherence process. Click here for more information.

2Create an app and select EPC Directory Service (EDS) API SRTP.

3Use dedicated sandbox credentials for authentication in the API sandbox.

4Click the Run in Postman button below to view, fork or download the postman collection which includes authentication API calls and sample EPC Directory Service (EDS) API calls.

5Refer to postman collection guide to configure variables.

Onboard to EPC Directory Service (EDS) API

This service is exclusive to participants of the EPC Directory Service (EDS). Follow steps below once the "documental" adherence to the VOP scheme or the SRTP is completed.

Step 1: Create a swift.com user and link to a BIC

To consume the EPC Directory Service (EDS) APIs, you need a registered swift.com account. Refer to Section 4 in the EPC Directory Service (EDS) Onboarding & Registration guidelines.

Step 2: Order EPC Directory Service (EDS) API

Log in to swift.com using the user account created in the previous step and submit the e-order to obtain the EPC Directory Service (EDS) contract.

Step 3: Create License ID and License Secret

After creating the EPC Directory Service (EDS) contract, follow these steps to create license ID and license secret pair used for authentication and authorisation to the API.

1As a Swift.com Admin for your institution, set up your Swift API Administrators.

2As a Swift API Administrator for your institution, create a License ID and Secret for your contract.

Step 4: Create application credentials for live API usage

1Make sure you are signed in with the account created in Step 2 via the option Sign in via Swift.com.

2Create an app with EPC Directory Service (EDS) API VOP or select EPC Directory Service (EDS) API SRTP.

3Promote this app to Live.

Making your first API call in the Live environment

If you have tested the API in the sandbox, swap out the sandbox URL with live URL api.swift.com, and swap out sandbox credentials with live credentials you created in Step 3 and Step 4, then start using the EPC Directory Service (EDS) API in the live environment!

If you have any questions about your integration, refer to the following resources:

Authentication to learn how to use your live credentials to access this API in the live environment as the credentials are different from what you may have used when testing in the sandbox.
API references to ensure valid API requests are sent and API responses are properly processed.
Error codes to learn about the errors when received and how to resolve them.