All

Returns all accounts belonging to a PSU and all relevant information about them. This endpoint should be called after refreshing PSU data on Salt Edge side.

CURL

curl -i  \ 
 -H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJkYXRhIjp7InBlcl9wYWdlIjo1MCwiZnJvbV9pZCI6NjY1fSwiZXhwIjoxNzM1MzUyNzMxLCJpc3MiOiJwcmlvcmEuc2FsdGVkZ2UuY29tIn0.uypdssSrplfoonwZrwX2COrToMuyg1Oq2s16X-YR5bGcAafllwSLwJ2OlIvJtoP8SH4CCkcSZeH1qrnb50S-HG9-TUFfNwdOif7K199eVJfOpK8motC9Sf6X9XckcjKB6fzO9RpZV7OQE7XF-1h2odESyMK6VqHM7LCFvLZOKc9SVFXVrDQSiopqjdVQ6e4lxu2yJ2VzahC5l-52Lfrcbb7fLJnYrpoejFI6wtcTjgYxr_HkaajRtPTQPEJTIUfHL-5yS2O3J6fHaDGYn9nG9AZPLMqLqimoqoHggpVxr741LlJbSIs3rNMaCx7JOro7t5c6Sl1xEZax0Lk_AJlPBg" \ 
 -H "App-Id: hdxOnJzz7tUdwso5TeGIOQ" \ 
 -H "App-Secret: mQdTa13N7SoBsmnoHok0mQ" \ 
 -H "Access-Token: 0bd6a34ce608515b9ce2c2afae5d52fa047aaa07c10563b9e7ef4e786faf935f29d255858fac37d314bef7d24651ddebe60cb4342d98e0feaee5ca010c500c04" \ 
 -H "Client-Request-Id: 34" \ 
 -X GET "/api/v2/accounts/all"

Example of request parameters

{"data":{"per_page":50,"from_id":665},"exp":1574093211}

Example of response

{"meta":{"time":"2019-11-18T16:04:51.182Z","next_id":865},"data":[{"id":"864","name":"Visa","nature":"credit_card","iban":"FK54RAND61068428516174","number":"450746508","sort_code":"16-26-63","swift_code":"qALtN","currency_code":"GBP","balance":37,"available_amount":30.5,"provider_account_id":"229","extra":{},"payment_account":true,"created_at":"2019-11-18T16:04:51.182Z","updated_at":"2019-11-18T16:04:51.182Z"}]}
Request

GET /api/v2/accounts/all

Headers
Header Type Description
Authorization string, required JSON Web Token containing payload, signed using RSA256 and application.private_key. Can raise: AuthorizationMissing
App-Id string, required Application’s app_id from connection details tab. Can raise: OauthAppNotFound, CertificateNotFound
App-Secret string, required Application’s app_secret from connection details tab.
Access-Token string, required Token for which we are requesting info. Can raise: TokenMissing, TokenNotFound, TokenRevoked, TokenExpired
Client-Request-Id string, optional Request identifier. If present, it will be returned within meta field in response.
Unpacked Request Authorization
exp
integer, required
The lifetime of the request in timestamp UTC format. Values greater than: Current time.
Response

Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.


Related Errors
Class Code Description
TokenMissing 400 This request cannot be performed without Access_Token header.
AuthorizationMissing 401 Authorization header is missing.
TokenNotFound 401 Token specified in request does not exist or cannot be retrieved.
TokenRevoked 401 Token specified in request is revoked and cannot be used anymore.
TokenExpired 401 Token specified in request is expired and cannot be used.
OauthAppNotFound 404 OAuth Application specified in request does not exist or cannot be retrieved.
CertificateNotFound 404 Certificate has no permissions.

Holder

Returns holder information that belongs to a PSU. This endpoint should be called after refreshing PSU data on Salt Edge side.

CURL

curl -i  \ 
 -H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJkYXRhIjp7fSwiZXhwIjoxNzM1MzUyNzMxLCJpc3MiOiJwcmlvcmEuc2FsdGVkZ2UuY29tIn0.O3Rh3rGDesJYf1XHP0SEGfENbbCBiFQfCpcXBvwkn70ea_MPwcWZ6fpJHwl-x8heW9evXji1XfS0gXFcj48l1RojsdZsQff2Qwpp3RpJY3cOY3egMVcDenCRXh_s2IjrCbHhAIFISxnFlNiCMS5QQzspCJQT5lAp9Njj-Q9IgY_0uJR8a-jCqrWSwdr1c5DL3dC3SY4Ba7-Ycn6pisVOVi2t-qQluIFaVb-PBrV40Z1VEozb5SqM_Y5HsLa5t0NYKqEfrtZ4UU93BHeGZWXYvKqPrJwkP0zNmqea4cl9PmsNo2bTZreTO26eTUHTSaGKHYGMcouA6PcfkUIzdkM3bQ" \ 
 -H "App-Id: HyR-HnEk7_WMUJv8BD6LkA" \ 
 -H "App-Secret: yqQW_-qL3l1YnoJyzDvX-g" \ 
 -H "Access-Token: 20442d11db40783035aa521337d264760fe46e0b241389fdc2081dae37a9952f6b5f58a7341a990c46a38b6b38c03770a4ecbd4d495c4030e323ad1b292d428f" \ 
 -H "Client-Request-Id: 17" \ 
 -X GET "/api/v2/accounts/holder"

Example of request parameters

{"data":{},"exp":1574093211}

Example of response

{"data":{"name":"John Smith"}}
Request

GET /api/v2/accounts/holder

Headers
Header Type Description
Authorization string, required JSON Web Token containing payload, signed using RSA256 and application.private_key. Can raise: AuthorizationMissing
App-Id string, required Application’s app_id from connection details tab. Can raise: OauthAppNotFound, CertificateNotFound
App-Secret string, required Application’s app_secret from connection details tab.
Access-Token string, required Token for which we are requesting info. Can raise: TokenMissing, TokenNotFound, TokenRevoked, TokenExpired
Client-Request-Id string, optional Request identifier. If present, it will be returned within meta field in response.
Unpacked Request Authorization
data
hash, required
Wrapper for the data.
exp
integer, required
The lifetime of the request in timestamp UTC format. Values greater than: Current time.
Response

Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.


Related Errors
Class Code Description
TokenMissing 400 This request cannot be performed without Access_Token header.
AuthorizationMissing 401 Authorization header is missing.
TokenNotFound 401 Token specified in request does not exist or cannot be retrieved.
TokenRevoked 401 Token specified in request is revoked and cannot be used anymore.
TokenExpired 401 Token specified in request is expired and cannot be used.
OauthAppNotFound 404 OAuth Application specified in request does not exist or cannot be retrieved.
CertificateNotFound 404 Certificate has no permissions.

Refresh

Initiates the process of refreshing PSU data (accounts, transactions, holder info) on Salt Edge PSD2 Compliance side from the ASPSP which issued the access token.

CURL

curl -i  \ 
 -H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJkYXRhIjp7ImZyb21fZGF0ZSI6IjIwMTktMDgtMTgiLCJ0b19kYXRlIjoiMjAxOS0xMS0xOCIsImluaXRpYXRlZF9ieV9jdXN0b21lciI6ZmFsc2UsInJlZGlyZWN0X3VybCI6Imh0dHBzOi8vdXNlci53aWxsLmJlL3JlZGlyZWN0ZWQvaGVyZSJ9LCJleHAiOjE3MzUzNTI3MzEsImlzcyI6InByaW9yYS5zYWx0ZWRnZS5jb20ifQ.jzfCQRxHea4GN7SttQK3JsXnGUAUypigkTHbux3-F4d5jK9Yam88A3IDdnwynO96J113OXcfBGndTnHoaF0Ud7D5hvQL8l3CTmbAVMjQG_oqUcvupeboOQRncs_SgzXKnPf84Y1fQ4eyEMpf6MFQtvjMIr17DQhz6dCVgL86rTmRV15tfsrkTg8vqQlJbt9urMdr7b-kqTahCRiAqmB9Yq0lNQfseeIdNIynFuHm0VQexHSCdN5I8mwZ0rKdol99F0IcQPu3PL64gSlr9F8ZkzOhhO_hN_LA69eBdPOPTGDfdN0d4w7pmMXWMAiJm90brvK7ybMZOppn7xgUbODNFA" \ 
 -H "App-Id: UJbEee74CaUNMzrvzfAtUQ" \ 
 -H "App-Secret: B_oeBL7GIK9jPxzQSrmlLQ" \ 
 -H "Access-Token: b2e3f5f24b69dad11a89e9fdada9dd695a1e8f965a3f33248ea41ae6ca46c0d3a2ea38233fe9b6cedeaa9067ee89bb87981d0988bd688e8b8056640c86350b6f" \ 
 -H "Client-Request-Id: 17" \ 
 -X PUT "/api/v2/accounts"

Example of request parameters

{"data":{"from_date":"2019-08-18","to_date":"2019-11-18","initiated_by_customer":false,"redirect_url":"https://user.will.be/redirected/here"},"exp":1574093211}

Example of response

{"data":{"session_secret":"fssZuhgv1LNyG_TaHmgv"}}
Request

PUT /api/v2/accounts

Headers
Header Type Description
Authorization string, required JSON Web Token containing payload, signed using RSA256 and application.private_key. Can raise: AuthorizationMissing
App-Id string, required Application’s app_id from connection details tab. Can raise: OauthAppNotFound, CertificateNotFound
App-Secret string, required Application’s app_secret from connection details tab.
Access-Token string, required Token for which we are requesting info. Can raise: TokenMissing, TokenNotFound, TokenRevoked, TokenExpired
Client-Request-Id string, optional Request identifier. If present, it will be returned within meta field in response.
Unpacked Request Authorization
exp
integer, required
The lifetime of the request in timestamp UTC format. Values greater than: Current time.
Response

Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.


Related Errors
Class Code Description
TokenMissing 400 This request cannot be performed without Access_Token header.
AuthorizationMissing 401 Authorization header is missing.
TokenNotFound 401 Token specified in request does not exist or cannot be retrieved.
TokenRevoked 401 Token specified in request is revoked and cannot be used anymore.
TokenExpired 401 Token specified in request is expired and cannot be used.
OauthAppNotFound 404 OAuth Application specified in request does not exist or cannot be retrieved.
CertificateNotFound 404 Certificate has no permissions.
ActionNotAllowed 406 You're not allowed to perform this action. This might be a configuration problem or parameters incompatibility.
AccessExceeded 429 Exceeded the number of automatic requests for this action.
AccessExceeded 429 Exceeded the number of automatic requests for this action.

Transactions

Returns transactions for a specific account. This endpoint should be called after refreshing PSU data on Salt Edge side.

CURL

curl -i  \ 
 -H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJkYXRhIjp7InBlcl9wYWdlIjo1MCwiZnJvbV9pZCI6MTY1fSwiZXhwIjoxNzM1MzUyNzMxLCJpc3MiOiJwcmlvcmEuc2FsdGVkZ2UuY29tIn0.QCUB0SVB_tUlh9CzamcwkUHI6PdX--1PUyHw2X0TDpKhjaTGD8P1sIG0-APjcL3KIDYW7sBblbP8ojfMn7vaVhrLqY8A0CYBgVoDPNh0QbuoTuOx3gNTvnzrz0jMgSNkC7U2lUU4FUn3SU4TwlMZJ7TDKCQgeGxHCe9j9zhrr7zcDIR4x8SOXJBXgOFenzdCHq-EJgRx3gdsuZh03OkxF7H8paAV-Da7n7vuxAis1LT_MtduO4_V8aqr0ErZO-TwNzcsivg5SsX7AHg9Y9DdXOKyf2XDQ1If_T92PKaT0G3uzYA9UY-Hl2tltsp1D-k7zWayDSPI1zzo0kCEUhCR1g" \ 
 -H "App-Id: 1aeKgOrMn24XdsU8K5vgNw" \ 
 -H "App-Secret: YTYP2gAUWcXW3l9wvtMT6w" \ 
 -H "Access-Token: cf3f53fd0422519c4259cbbad9cdd556a5e6e03618a474431823e394b6f1204c98a46609f0606e8920a153665175739cc0174f721b263aeb0838f1a1afef8d3e" \ 
 -H "Client-Request-Id: 17" \ 
 -X GET "/api/v2/accounts/:account_id/transactions"

Example of request parameters

{"data":{"per_page":50,"from_id":165},"exp":1574093211}

Example of response

{"meta":{"time":"2019-11-18T16:04:51.253Z","next_id":1055},"data":[{"id":1054,"account_id":711,"currency_code":"EUR","amount":16.54,"fees":[{}],"description":"Internal transfer.","extra":{},"provider_transaction_id":"614","made_on":"2019-11-18T16:04:51.252Z","status":"posted","category":"transfer","created_at":"2019-11-18T16:04:51.253Z","updated_at":"2019-11-18T16:04:51.253Z"}]}
Request

GET /api/v2/accounts/:account_id/transactions

Headers
Header Type Description
Authorization string, required JSON Web Token containing payload, signed using RSA256 and application.private_key. Can raise: AuthorizationMissing
App-Id string, required Application’s app_id from connection details tab. Can raise: OauthAppNotFound, CertificateNotFound
App-Secret string, required Application’s app_secret from connection details tab.
Access-Token string, required Token for which we are requesting info. Can raise: TokenMissing, TokenNotFound, TokenRevoked, TokenExpired
Client-Request-Id string, optional Request identifier. If present, it will be returned within meta field in response.
Unpacked Request Authorization
exp
integer, required
The lifetime of the request in timestamp UTC format. Values greater than: Current time.
account_id (path)
integer, required
Account identifier on Salt Edge PSD2 Compliance Solution. Can raise: AccountNotFound
Response

Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.


Related Errors
Class Code Description
TokenMissing 400 This request cannot be performed without Access_Token header.
AuthorizationMissing 401 Authorization header is missing.
TokenNotFound 401 Token specified in request does not exist or cannot be retrieved.
TokenRevoked 401 Token specified in request is revoked and cannot be used anymore.
TokenExpired 401 Token specified in request is expired and cannot be used.
AccountNotFound 404 Account specified in request does not exist or cannot be retrieved.
OauthAppNotFound 404 OAuth Application specified in request does not exist or cannot be retrieved.
CertificateNotFound 404 Certificate has no permissions.