Skip to main content
The payload for a webhook is a single event referencing a resource that has recently changed. The data in target always represents a nested resource as returned by our regular API endpoints.
{
  "type": "event",
  "id": "347901e1-8b53-42a4-951b-ec546a5078f1",
  "name": "transaction.captured",
  "created_at": "2012-12-12T10:53:43+00:00",
  "merchant_account_id": "mattilda",
  "gr4vy_id": "mattilda",
  "environment": "sandbox",
  "target": {
    "type": "transaction",
    "id": "795c27e9d-6cc3-40f6-a359-1355c434c30d",
    "status": "capture_succeeded",
    "payment_method": {
      "method": "card"
    },
    "external_identifier": "order-1234",
    "amount": 1299,
    "currency": "MXN",
    "authorized_amount": 1299,
    "captured_amount": 1299,
    "refunded_amount": 0,
    "payment_service_transaction_id": "8110000000002017185",
    "payment_link_id": null,
    "pending_review": false,
    "error_code": null,
    "metadata": {
      "profile": "profile-1234"
    },
    "created_at": "2024-09-17T16:54:57.333316+00:00",
    "updated_at": "2024-09-17T16:55:06.560721+00:00"
  }
}
{
  "type": "event",
  "name": "buyer.created",
  "id": "d99a867a-a326-447f-b61e-2825ebe6f0c5",
  "merchant_account_id": "mattilda",
  "gr4vy_id": "mattilda",
  "environment": "sandbox",
  "created_at": "2024-11-20T16:50:52.609674+00:00",
  "target": {
    "type": "buyer",
    "id": "f9d46f71-60d8-4b61-bddb-001a04c8224c",
    "display_name": "John Smith",
    "external_identifier": "user-123",
    "created_at": "2024-11-20T16:50:52.603191+00:00",
    "updated_at": "2024-11-20T16:50:52.603191+00:00",
    "billing_details": {
      "first_name": "John",
      "last_name": "Smith",
      "email_address": "john@example.com",
      "phone_number": "+1234567890",
      "address": {
        "city": "Springfield",
        "country": "US",
        "postal_code": "123456",
        "state": "CA",
        "state_code": "US-CA",
        "house_number_or_name": "21",
        "line1": "22nd Street",
        "line2": "",
        "organization": "mattilda"
      },
      "tax_id": {
        "value": "12-3456789",
        "kind": "us.ein"
      }
    }
  }
}
{
  "type": "event",
  "id": "347901e1-8b53-42a4-951b-ec546a5078f1",
  "name": "payment-method.updated",
  "created_at": "2012-12-12T10:53:43+00:00",
  "merchant_account_id": "mattilda",
  "gr4vy_id": "mattilda",
  "environment": "sandbox",
  "target": {
    "type": "payment-method",
    "id": "8d29457b-683a-49c4-8afd-800cd7117236",
    "status": "succeeded",
    "method": "card",
    "external_identifier": null,
    "created_at": "2024-09-17T16:57:48.393644+00:00",
    "updated_at": "2024-09-17T16:57:50.553736+00:00"
  }
}
{
  "type": "event",
  "id": "347901e1-8b53-42a4-951b-ec546a5078f1",
  "name": "refund.succeeded",
  "created_at": "2012-12-12T10:53:43+00:00",
  "merchant_account_id": "mattilda",
  "gr4vy_id": "mattilda",
  "environment": "sandbox",
  "target": {
   "type": "refund",
    "id": "a994ec53-23b3-42e5-ab44-e4942d8aa7ba",
    "transaction_id": "7ef82ff4-5862-4d2b-8bd0-4cbf86668fc5",
    "payment_service_refund_id": "148206c4-fc32-44f3-906a-3d1b35865c19",
    "amount": 1299,
    "currency": "MXN",
    "status": "succeeded",
    "target_id": null,
    "created_at": "2024-11-07T11:07:18.955537+00:00",
    "updated_at": "2024-11-07T11:07:19.111351+00:00",
    "transaction_external_identifier": "tx-123",
    "external_identifier": "refund-234",
    "target_type": "payment-method",
    "reconciliation_id": "59zlCXgKuGfCz0wc8cTnOk",
    "transaction_reconciliation_id": "3raSDUgac8qWle5IbcZiMP"
  }
}
{
  "type": "event",
  "id": "347901e1-8b53-42a4-951b-ec546a5078f1",
  "name": "report-execution.succeeded",
  "created_at": "2012-12-12T10:53:43+00:00",
  "merchant_account_id": "mattilda",
  "gr4vy_id": "mattilda",
  "environment": "sandbox",
  "target": {
    "type": "report-execution",
    "id": "8d29457b-683a-49c4-8afd-800cd7117236",
    "status": "succeeded",
    "report": {
      "type": "report",
      "id": "5b98970d-c6ee-48f1-a096-c5d37761f329"
    },
    "created_at": "2024-09-17T16:49:55.064633+00:00",
    "updated_at": "2024-09-17T16:50:05.134346+00:00"
  }
}
{
    "type": "event",
    "name": "shipping-details.created",
    "id": "702863ee-fd78-467d-a0a7-533bf429b39c",
    "created_at": "2024-11-20T12:48:38.409619+00:00",
    "merchant_account_id": "mattilda",
    "gr4vy_id": "mattilda",
    "environment": "sandbox",
    "target": {
        "type": "shipping-details",
        "id": "3dda8d7a-e7cd-43b8-9128-21adf1ec868b",
        "buyer_id": "baa7b3b3-a4f1-49e3-afb0-0f41b48f5aa2",
        "first_name": "John",
        "last_name": "Smith",
        "email_address": "john@example.com",
        "phone_number": "+1234567890",
        "address": {
            "city": "Springfield",
            "country": "MX",
            "postal_code": "123456",
            "state": "CA",
            "state_code": "US-CA",
            "house_number_or_name": "21",
            "line1": "22nd Street",
            "line2": "",
            "organization": "mattilda"
        },
        "created_at": "2024-11-20T12:48:38.402474+00:00",
        "updated_at": "2024-11-20T12:48:38.402474+00:00"
    }
}