Setting up Stripe Identity

Prev Next

Preliminary Remarks

To use Stripe Identity, the service must be activated and configured in the Stripe backend. This article provides the necessary instructions for creating the data required for linking with Frisbii Media.

Note:

The following data can be created independently for the Frisbii Media stage system and the live system.

  • Test data created in the Stripe backend is used for the Frisbii Media Stage system.

  • Live data created in the Stripe backend is used for the Frisbii Media Live system.


Create a restricted API key

When using Stripe Identity, any API keys already created for linking Stripe as a payment service provider cannot be used. Instead, it is necessary to use a so-called "restricted API key" to access sensitive verification results. Such API keys offer greater security in comparison.

Procedure in the Stripe backend:

  • In the dashboard, go to API keys tab and click on "Create restricted key".

  • Define a name for the key.

  • Set the following resource types:

    • Verification Sessions and Reports: Write

    • Access recent detailed verification results: Read

    • Access all detailed verification results: None

  • All other resource types can remain at "None" for the use of Stripe Identity.

  • Click on "Create key".

  • The created key starts with the prefix:

    • rk_test_xxxxx for the stage system

    • rk_live_xxxxx for the live system

  • Save the created key in a secure manner. The key cannot be viewed again at a later date!

Stripe also describes the creation process in its Stripe Identity documentation.


Other necessary data

Additional data is required to link Stripe Identity. With the exception of the restricted API key described above, the data that has already been used to link Stripe as a payment service provider can be used.

  • Stripe Account (uniqueId) - key structure: acct_xxxxx

  • Secret key (restricted API key) - structure of the key:

    • rk_test_xxxxx for the stage system

    • rk_live_xxxxx for the live system

  • Publishable key - Structure of the key

    • pk_test_xxxxx for the stage system

    • pk_live_xxxxx for the live system

  • Webhook - Structure of the key: whsec_xxxxx

Once all the data is available, it can be stored in the Frisbii Media Merchant Backend.


Notes on testing age-related rules with Stripe Identity

Variable age data from test customers cannot be used for tests on the Frisbii Media Stage system. Instead, Stripe offers a single test case.  The test person permanently defined by Stripe is older than 30 years. This fact should be taken into account when creating age-related rules on the Frisbii Media Stage system.

More information on age-related rules and examples can be found here: Age-related rules