v1

latestOpenAPI 3.0.02026-07-2417129274.8 KB

Automation Endpoints

Chargeback

Notifies Riskified that a chargeback has been submitted for a specific order. Note: Riskified offers fully automated chargeback gateway integrations for major gateways: Braintree, Stripe, Adyen, PayPal; this process automates end-to-end chargeback handling from chargeback reporting to the disputing process. Riskified stands behind its chargeback guarantee for all approved orders.

post/api/chargeback

Headers

x-riskified-shop-domainstring required

Example:merchant.example.com

The merchant shop domain registered with Riskified.

x-riskified-hmac-sha256string required

Example:b1946ac92492d2347c6235b4d2611184

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.

content_type'application/json' required

As payloads are sent to Riskified in JSON format, value should be: application/json

accept'application/vnd.riskified.com; version=2' required

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": {
    "chargeback_details": {
      "transaction_id": "1215540751846411",
      "credit_card_bin": "11122233",
      "credit_card_last_four_digits": "4536",
      "transaction_store_id": "store_nyc_01",
      "transaction_point_of_sale": "pos_terminal_07",
      "transaction_cash_register_number": "register_03"
    },
    "fulfillment": {
      "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"
        }
      ]
    }
  }
}

Response

Successful operation

Example response

{
  "order": {
    "id": "53953819"
  }
}