Riskified Documentation

Guide to API Integration with
Stripe as Gateway


This document was written to guide merchants who are integrating via the Riskified API, and would like to use Stripe to share payment information for all, or some of their orders. Riskified’s 3rd party access to Stripe facilitates the flow of payment information for orders placed in your store that were processed by Stripe.

Please refer to both this document and the Riskified API Integration Guide for step-by-step instructions to completing the standard API integration process. This document will highlight the additions to the standard process.


Integration steps when using Stripe as a gateway


Connect to Riskified in Sandbox

Follow step 1 of the API integration (Sandbox). In addition to the specified actions, you must give Riskified authorization to access your Stripe sandbox account as a 3rd party:

Steps for connecting Riskified with Stripe:

  • Go to the the following link. Once you click the link, you will be directed to a Stripe authorization page.

  • To connect Riskified with Stripe you must be logged in to your Stripe account. If you are not signed in to Stripe, click 'Sign in with Stripe to connect'. If you are already logged in to Stripe, click 'Connect my Stripe account'.

  • You will then be redirected back to your Riskified Sandbox environment


Send Riskified charge id

Riskified uses the Stripe charge id to receive full payment information for your orders. Before carrying out Action 2 in the guide (validate order data), please add the Stripe charge id under Payment Details 'authorization id' field (see example below). This will ensure that Riskified can pull the relevant payment information fields from Stripe. See relevant section in our API ref.

Example

        "order" : {
        ...
        "payment_details" : {
        "authorization_id" : "charge_15BZxW2eZvKYlo2CvQbr1111"
        },
        ...
        

Connect to Riskified in production

In step 3 of the API integration (Production), in addition to the specified actions, you will be required to give Riskified authorization to access your Stripe production account as a 3rd party, just as you did previously in Sandbox.

Steps for connecting Riskified with Stripe:

  • Go to the the following link. Once you click the link, you will be directed to a Stripe authorization page.

  • To connect Riskified with Stripe, you must be logged in to your Stripe account. If you are not signed in to Stripe, click 'Sign in with Stripe to connect'. If you are already logged in to Stripe, click 'Connect my Stripe account'.

  • You will then be redirected back to the Riskified integration management application.