Webhooks

Bytex Marketplace Knowledge Database

Vendors – API Documentation Webhooks

This article describes how to integrate our payment platform into your website logic via webhooks.

General Information

All webhooks are called from the host webhooks.bytex.market. Any webhook call from a different host should be dismissed.
All webhook calls are POST requests.
All webhooks have a header set called EVENT. The value is specified by the individual webhooks.

Available webhooks

Purchase Completed
Description Called when a purchase is completely done, meaning the payment has arrived and the license has been created.
EVENT header set to ON_PURCHASE_COMPLETED
Sends payload as JSON Body
Example body
{
   "order":{
      "identifier":"B409908375",
      "timeCreated":"2018-11-17T18:27:14.423335",
      "totalPrice":10.000000000000000000000000000,
      "payerIdentity":{
         "identifier":"K396677386",
         "firstName":"Erika",
         "lastName":"Mustermann",
         "email":"[email protected]",
         "isEmailVerified":true,
         "countryCode":"DEU"
      },
      "paymentProviderId":1,
      "runtimeLength":-1,
      "runtimeOptionCustomIdentifier":"7fbdc628-893c-4499-844c-7a8c7ecaf325",
      "productSku":"nd79z8jinqmkmtewfrb5"
   },
   "license":{
      "productSku":"nd79z8jinqmkmtewfrb5",
      "issuedTo":"K396677386",
      "validFrom":"2018-11-17T18:27:21.21126",
      "validUntil":"9999-01-01T00:00:00",
      "isPermanent":true,
      "keyIdentifier":"6b3d646f-cb20-4fc5-b520-e53227379407",
      "isActive":true
   }
}
Refund Update
Description Called when a dispute is opened, a refund is issued, a dispute is closed and a refund is reversed.
EVENT header set to ON_REFUND_UPDATE
Sends payload as JSON Body
Example body
{
   "order":{
      "identifier":"B966149669",
      "timeCreated":"2018-11-17T18:42:27.83143",
      "totalPrice":10.000000000000000000000000000,
      "payerIdentity":{
         "identifier":"K396677386",
         "firstName":"Erika",
         "lastName":"Mustermann",
         "email":"[email protected]",
         "isEmailVerified":true,
         "countryCode":"DEU"
      },
      "paymentProviderId":1,
      "runtimeLength":-1,
      "runtimeOptionCustomIdentifier":"7fbdc628-893c-4499-844c-7a8c7ecaf325",
      "productSku":"nd79z8jinqmkmtewfrb5"
   },
   "license":{
      "productSku":"nd79z8jinqmkmtewfrb5",
      "issuedTo":"K396677386",
      "validFrom":"2018-11-17T18:42:31.806403",
      "validUntil":"9999-01-01T00:00:00",
      "isPermanent":true,
      "keyIdentifier":"4bded513-6f64-418e-8139-f6ebeab825aa",
      "isActive":true
   },
   "updateReasonId":0
}
Additional notes The field updateReasonId has a value between 0-3.
Value Meaning
0 Dispute Opened
1 Dispute Closed
2 Payment Refunded
3 Payment Refund Reversed (Chargeback Won)