v1
latestOpenAPI 3.0.02026-07-2417129274.8 KBAuthorized Order Review (Asynchronous)
The /submit endpoint sends transaction data to Riskified after the gateway authorizes the transaction for fraud analysis. Because this is an asynchronous endpoint, the fraud decision is returned via your pre-configured notification URL. If your account is under Shop Protection, transactions are automatically submitted for review.
The /submit endpoint returns a synchronous response confirming receipt of the order. Riskified’s fraud decision is then sent asynchronously to your notification endpoint.
If order data changes after an initial approved decision, call /submit again with the updated order details to receive a new decision. When sending updated order details, be sure to pass the same order ID that was used in the initial /submit request.
Note for existing integrations: If your integration already uses the /create or /update endpoints, no additional work is required. These endpoints provide the same order submission and decisioning functionality as /submit, and automatically send transactions to Riskified for review.
Headers
The merchant shop domain registered with Riskified.
Verification hash for the Request. Generated by performing an SHA256 encryption on the request's POST body and calculating the HMAC hash of the result using your Riskified authentication token. Please use UTF8 encoding.
As payloads are sent to Riskified in JSON format, value should be: application/json
Specify the version of the API to target. For example, to target the latest version of the API, use the following: application/vnd.riskified.com; version=2
Request body
Example request
{
"order": {
"id": "123456",
"email": "guest.customer@example.com",
"created_at": "2025-11-15T10:00:00Z",
"currency": "USD",
"gateway": "adyen",
"browser_ip": "203.0.113.45",
"total_price": 145.99,
"total_discounts": 10,
"referring_site": "https://www.google.com/search?q=best+shoes",
"line_items": [
{
"price": 20,
"quantity": 1,
"title": "Tempered Glass Guard for Apple iPhone X",
"product_id": "ABC123",
"category": "On Sale",
"brand": "Complete Cover",
"product_type": "physical",
"requires_shipping": true,
"sku": "sj18fn402",
"sub_category": "Super Sale",
"condition": "new",
"seller": null,
"delivered_at": "2025-12-01T10:00:00Z",
"delivered_to": "shipping_address",
"drop_point": null,
"size": "Small",
"registry_type": null,
"shipping_address_id": "addr_ship_01"
}
],
"shipping_lines": [
{
"price": 15,
"title": "Express 2-Day Shipping",
"code": "EXPRESS",
"company": "DHL Express",
"shipping_address_id": "addr_ship_01"
}
],
"payment_details": [
{
"payment_type": "card",
"credit_card_bin": "482932",
"credit_card_company": "Visa",
"credit_card_number": "9876",
"credit_card_country": "US",
"credit_card_token": "tok_preauth_XYZ789",
"cardholder_name": "John Test Customer",
"mid": "PREAUTH_MID_456",
"id": "pmt_pre_01",
"stored_payment_created_at": "2024-05-15T10:00:00Z",
"stored_payment_updated_at": "2024-11-01T14:30:00Z",
"installments": 1,
"acquirer_bin": "999999",
"acquirer_region": "NONEU",
"expiry_month": 12,
"expiry_year": 2028,
"initial_payment_amount": 410,
"payment_frequency": 1,
"billing_address_id": "addr_bill_01"
}
],
"customer": {
"email": "customer@example.com",
"verified_email": true,
"first_name": "John",
"last_name": "Doe",
"id": "123456",
"created_at": "2023-01-15T10:00:00-05:00",
"orders_count": 5,
"account_type": "registered",
"phone": "+1234567890",
"verified_phone": true,
"date_of_birth": "1990-05-20",
"gender": "male",
"user_name": "john_doe",
"address": {
"first_name": "John",
"last_name": "Test",
"address1": "123 Smart St",
"country": "United States",
"country_code": "US",
"phone": "+143873984567290",
"city": "Los Angeles",
"zip": "90210",
"province": "California",
"address2": "Apt 4B",
"company": "My Company",
"additional_phone": "+14245551234",
"verified_phone": true,
"province_code": "CA",
"latitude": 34.0522,
"longitude": -118.2437,
"id": "addr_cust_01"
}
},
"billing_address": [
{
"first_name": "John",
"last_name": "Test",
"address1": "123 Smart St",
"country": "United States",
"country_code": "US",
"phone": "+143873984567290",
"city": "Los Angeles",
"zip": "90210",
"province": "California",
"address2": "Apt 4B",
"company": "My Company",
"additional_phone": "+14245551234",
"verified_phone": true,
"province_code": "CA",
"latitude": 34.0522,
"longitude": -118.2437,
"id": "addr_cust_01"
}
],
"shipping_address": [
{
"first_name": "John",
"last_name": "Test",
"address1": "123 Smart St",
"country": "United States",
"country_code": "US",
"phone": "+143873984567290",
"city": "Los Angeles",
"zip": "90210",
"province": "California",
"address2": "Apt 4B",
"company": "My Company",
"additional_phone": "+14245551234",
"verified_phone": true,
"province_code": "CA",
"latitude": 34.0522,
"longitude": -118.2437,
"id": "addr_cust_01"
}
],
"source": "desktop_web",
"ai_agent": "chatgpt",
"client_details": {
"accept_language": "en-CA",
"user_agent": "Mozilla/5.0 (CFNetwork/548.0.3 Darwin/11.2.0)"
},
"name": "#10245",
"cart_token": "CART-XYZ-78901234567890",
"checkout_id": "CHK-A1B2C3D4E5F6",
"updated_at": "2025-11-15T10:05:00Z",
"note": "Customer requested delivery before end of week.",
"passengers": [
{
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "2015-07-28",
"nationality_code": "US",
"passenger_type": "Child",
"document_number": "P12345678",
"document_type": "Passport",
"insurance_type": "Basic Travel",
"insurance_price": 25,
"document_issue_date": "2020-03-15",
"document_expiration_date": "2030-03-15"
}
],
"discount_codes": [
{
"amount": 10,
"code": "TENOFF"
}
],
"vendor_id": "VNDR-12345",
"vendor_name": "Affiliate Travel Partner",
"order_type": "test",
"submission_reason": "rule_decision",
"decision": {
"external_status": "approved",
"decided_at": "2025-11-19T16:15:00Z",
"reason": "Approved by automated risk system",
"amount": 400,
"currency": "USD",
"notes": "No suspicious activity detected; customer history clear."
},
"charge_free_payment_details": [
{
"amount": 50,
"gateway": "giftcard"
}
],
"partner_sub_merchant_id": "Merchant1",
"invoice_id": "europe"
}
}Response
Successful operation
Example response
{
"order": {
"id": "53953819"
}
}