Emulation

Emulation features are only available in Sandbox environment.

Simulate SCA Proof

The /simulation/scaProof endpoint allows you to simulate an SCA proof.

Parameters

Attribute	Type	Description
scaWalletId	string	The unique identifier of the SCA Wallet from which the scaProof is to be created.
url	string	The URL of the endpoint for which the sensitive action is to be secured with strong customer authentication.
body	string	Data to sign in the SCA proof body. See the Per Operation table to know which data to sign for each endpoint.

Request

In order to generate an SCA Proof in Sandbox, you must use a JWT accessToken with a client_credentials grant type and the admin scope. See the Authentication article for more information.

CURL

curl -X POST {baseUrl}/simulation/scaProof \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json'

Here is a {payload} example:

JSON

{
    "scaWalletId": "string",    // required
    "url": "string",            // optional
    "body": {"string"}          // optional
}

Returns the SCA proof.

JSON

{
    "scaProof": "string"
}

Worked example

Let's take an example where you want to test in Sandbox the creation of a new Beneficiary, an action which requires strong customer authentication.

The steps are the following:

1. Use the simulator as the App
2. Simulate an SCA proof as the App
3. Authenticate as end user
4. Simulate SCA Proof as App
5. Create the beneficiary as end user

Prerequisites

A User must be already created, with an active SCA Wallet.

1. Use the simulator as the App

Authenticate as the application to use the simulator. Here is the authentication request:

CURL

curl -X POST {baseUrl}/oauth/token \
	--form 'grant_type="client_credentials"' \
    --form 'client_id="{clientId}"' \
    --form 'client_secret="{clientSecret}"' \
    --form 'scope="admin"'

Returns the Bearer token:

JSON

{
    "token_type": "Bearer",
    "expires_in": 3600,
    "access_token": "eyJ0_XXX_DSnw"
}

2. Simulate an SCA proof as the App

Use the simulator to create an SCA proof that you'll be able to use to authenticate as the end user in the next step.

CURL

curl -X POST {baseUrl}/simulation/scaProof \
	--header 'Authorization: Bearer eyJ0_XXX_DSnw' \
	--header 'Content-Type: application/json' \
    --data '{payload}'

With the user's scaWalletId in the {payload}:

JSON

{
    "scaWalletId": "e59b5fadd69f4d2693a60492b0334464"
}

Returns the SCA Proof:

JSON

{
    "scaProof": "eyJh_NDN9.WQBp_Xg7w"
}

3. Authenticate as end user

Authenticate as the end user to create the beneficiary. Here is the authentication request:

CURL

curl -X POST {baseUrl}/oauth/token \
	--form 'grant_type="delegated_end_user"' \
    --form 'client_id="{clientId}"' \
    --form 'client_secret="{clientSecret}"' \
    --form 'scope="read_write"' \
    --form 'username="101109094"' \
    --form 'password="bc6ead2bbcd9cc409ba53d9cfbf145a667647414eae496xxxx75636b15384a8"'  \
    --form 'sca="eyJh_NDN9.WQBp_Xg7w"'

Returns the Bearer token:

JSON

{
    "token_type": "Bearer",
    "expires_in": 3600,
    "access_token": "eyJ0_XXX_q44Q"
}

4. Simulate SCA Proof as App

CURL

curl -X POST {baseUrl}/simulation/scaProof \
	--header 'Authorization: Bearer eyJ0_XXX_DSnw' \
	--header 'Content-Type: application/json' \
    --data '{payload}'

With the following {payload} which contains the data to sign:

JSON

{
    "scaWalletId": "e59b5fadd69f4d2693a60492b0334464", 
    "url": "https://yourcompanyname.sandbox.treezor.co/v1/beneficiaries", 
    "body": { 
        "userId": "101109094",
        "name": "Alex Oak",
        "adress": "33 av de Wagram Paris",
        "iban": "FR1130003000305928344XXXXX",
        "bic": "SOGEFRPPXXX",
        "usableForSct": true
    }
}

Returns the SCA Proof:

JSON

{
    "scaProof": "eyJh_UxfQ.nNIH_n9kA"
}

5. Create the beneficiary as end user

CURL

curl -X POST {baseUrl}/v1/beneficiaries \
	--header 'Authorization: Bearer eyJ0_XXX_q44Q' \
	--header 'Content-Type: application/json'\
    --data '{payload}'

With the following {payload}:

JSON

{
    "userId": "101109094",
    "name": "Alex Oak",
    "adress": "33 av de Wagram Paris",
    "iban": "FR1130003000305928344XXXXX",
    "bic": "SOGEFRPPXXX",
    "usableForSct": true,
    "sca":"eyJh_UxfQ.nNIH_n9kA" 
}

Returns the Beneficiary object:

JSON

{
    "beneficiaries": [
        {
            "id": 527977,
            "tag": "",
            "userId": 101109094,
            "nickName": "",
            "name": "Alex Oak",
            "address": "",
            "iban": "3537524356444355504255444055564B574C405157455041XXXX",
            "bic": "SOGEFRPPXXX",
            "sepaCreditorIdentifier": "",
            "sddB2bWhitelist": [],
            "sddCoreBlacklist": [],
            "usableForSct": true,
            "sddCoreKnownUniqueMandateReference": [],
            "isActive": true,
            "createdDate": "2024-11-21 08:05:56",
            "modifiedDate": "2024-11-21 08:05:56",
            "metadata": {
                "iban": "FR1130003000305928344XXXXX"
            }
        }
    ]
}