> For the complete documentation index, see [llms.txt](https://startbutton.gitbook.io/startbutton-product-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://startbutton.gitbook.io/startbutton-product-api/webhooks/conversion-events.md).

# Conversion Events

### Supported events for Conversion:

1. conversion.successful
2. conversion.pending
3. conversion.failed

{% tabs %}
{% tab title="Successful" %}

```json
{ 
  "event": "conversion.successful", 
  "data": { 
    "transaction": { 
      "_id": "66xxxxxxxxxxxx", 
      "transType": "conversion", 
      "status": "successful", 
      "fromAmount": 1000, 
      "toAmount": 1593050, 
      "fromCurrency": "USD", 
      "toCurrency": "NGN", 
      "merchantId": "65xxxxxxxxxx", 
      "transactionReference": "dbxxxxxxx", 
      "isRecurrent": false, 
      "createdAt": "2024-08-25T23:44:33.513Z", 
      "updatedAt": "2024-08-25T23:44:37.346Z", 
      "amount": 100000, 
      "currency": "USD", 
      "feeAmount": null 
    }, 
    "authorizationCode": null 
  } 
}
```

{% endtab %}

{% tab title="Pending" %}

```json
{ 
  "event": "conversion.pending", 
  "data": { 
    "transaction": { 
      "_id": "66cxxxxxxxxxxxx", 
      "transType": "conversion", 
      "status": "initiated", 
      "fromAmount": 1000, 
      "toAmount": 1593050, 
      "fromCurrency": "USD", 
      "toCurrency": "NGN", 
      "merchantId": "65xxxxxxxxxxx", 
      "transactionReference": "dbxxxxxxxx", 
      "isRecurrent": false, 
      "createdAt": "2024-08-25T23:44:33.513Z", 
      "currency": "USD", 
      "feeAmount": null 
    }, 
    "authorizationCode": null 
  } 
}
```

{% endtab %}

{% tab title="Failed" %}

```json
{ 
  "event": "conversion.failed", 
  "data": { 
    "transaction": { 
      "_id": "66xxxxxxxxxxxxxxx", 
      "transType": "conversion", 
      "status": "failed", 
      "merchantId": "65xxxxxxxxxxxxx", 
      "transactionReference": "f1418761c7ab", 
      "isRecurrent": false, 
      "createdAt": "2024-08-23T08:41:32.036Z", 
      "updatedAt": "2024-08-23T08:41:32.247Z", 
      "amount": 1000000, 
      "currency": "USD", 
      "feeAmount": null 
    }, 
    "authorizationCode": null 
  } 
}
```

{% endtab %}
{% endtabs %}