Collections

To have the real-time updates between TransFi and Customers, we are configuring the webhook events to be sent to Customers on below events.

Events	Event Type	Status	Descriptions
Payment Initiated	Order	`initiated`	Post confirming the order details, wallet address, and payment method selection, the user will be redirecting to the payment checkout page
Payment Authorised	Order	`fund_settled`	User has submitted the payment details on the payment checkout page and the confirmation is received from the bank
Payment Unauthorised	Order	`fund_failed`	User has submitted the payment details on the payment checkout page and the payment is declined from the bank

Sample Event For Order:

{
  "entityId": "OR-240726094358",
  "entityType": "order",
  "orgId": "OG-231207102120",
  "eventId": "EV-240726134541710",
  "order": {
    "orderId": "OR-240726094358",
    "type": "payin",
    "fiatTicker": "EUR",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 100,
    "paymentType": "sepa_bank",
    "txnHash": "",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2024-11-27T05:09:15.027Z",
    "customerOrderId": "",
    "failureCode": ""
  },
  "partnerContext": {},
  "status": "initiated",
  "user": {
    "userId": "UX-240625104122",
    "firstName": "test",
    "lastName": "user",
    "country": "DE",
    "createdAt": "2024-11-27T05:09:15.027Z"
  }
}

{
  "entityId": "OR-240726094358",
  "entityType": "order",
  "orgId": "OG-231207102120",
  "eventId": "EV-240726134541710",
  "order": {
    "orderId": "OR-240726094358",
    "type": "payin",
    "fiatTicker": "EUR",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 100,
    "paymentType": "sepa_bank",
    "txnHash": "",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2024-11-27T05:09:15.027Z",
    "customerOrderId": "",
    "failureCode": ""
  },
  "partnerContext": {},
  "status": "fund_settled",
  "user": {
    "userId": "UX-240625104122",
    "firstName": "test",
    "lastName": "user",
    "country": "DE",
    "createdAt": "2024-11-27T05:09:15.027Z"
  }
}

{
  "entityId": "OR-240726094358",
  "entityType": "order",
  "orgId": "OG-231207102120",
  "eventId": "EV-240726134541710",
  "order": {
    "orderId": "OR-240726094358",
    "type": "payin",
    "fiatTicker": "EUR",
    "cryptoTicker": "",
    "cryptoNetwork": "",
    "fiatAmount": 100,
    "paymentType": "sepa_bank",
    "txnHash": "",
    "walletAddress": "",
    "destinationWalletAddress": "",
    "createdAt": "2024-11-27T05:09:15.027Z",
    "customerOrderId": "",
    "failureCode": ""
  },
  "partnerContext": {},
  "status": "fund_failed",
  "user": {
    "userId": "UX-240625104122",
    "firstName": "test",
    "lastName": "user",
    "country": "DE",
    "createdAt": "2024-11-27T05:09:15.027Z"
  }
}