---
updatedAt: 2026-06-17T10:23:17.000Z
agentTools:
  projectIndex: https://checkout-docs.transfi.com/llms.txt
---

# Payin

This section provides the list of webhook events that can be received for Payin (Collections) orders.

To enable real-time updates between TransFi and Customers, webhook notifications are triggered throughout the complete order lifecycle.

# Fiat Payin Order Events

## Order Statuses

| Event                | Entity Type | Status            | Description                                                                                                                           |
| -------------------- | ----------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Payment Initiated    | Order       | `initiated`       | After confirming the order details, wallet address, and payment method selection, the user is redirected to the payment checkout page |
| Payment Processing   | Order       | `fund_processing` | The user has submitted payment details and the payment is being processed/confirmed by the bank                                       |
| Payment Authorised   | Order       | `fund_settled`    | User has successfully submitted payment details and the payment has been confirmed by the bank                                        |
| Payment Unauthorised | Order       | `fund_failed`     | User submitted payment details, but the payment was declined by the bank                                                              |
| Manual Review        | Order       | `manual_review`   | The order has been placed on hold for manual review by the compliance team                                                            |

## Sample Webhook Payloads

```json Initiated
{
  "eventId": "EV-260305125748417",
  "entityId": "OR-2603051257371591318",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051257371591318",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T12:57:45.963Z",
    "customerOrderId": "OR-2603051257371591318"
  },
  "createdAt": "2026-03-05T12:57:48.300Z"
}
```
```json Fund Settled
{
  "eventId": "EV-260305134150953",
  "entityId": "OR-2603051257371591318",
  "entityType": "order",
  "status": "fund_settled",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051257371591318",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T12:57:45.963Z",
    "customerOrderId": "OR-2603051257371591318"
  },
  "createdAt": "2026-03-05T13:41:50.150Z"
}
```
```json Fund Failed
{
  "eventId": "EV-260305134619934",
  "entityId": "OR-2603051342464057762",
  "entityType": "order",
  "status": "fund_failed",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051342464057762",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T13:42:55.268Z",
    "customerOrderId": "OR-2603051342464057762",
    "failureCode": "PAYMENT_NOT_COMPLETED",
    "failureMessage": "Payment was not completed. Please try again."
  },
  "createdAt": "2026-03-05T13:46:19.204Z"
}
```
```json Manual Review
{
  "eventId": "EV-260305135517882",
  "entityId": "OR-2603051354232446017",
  "entityType": "order",
  "status": "manual_review",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051354232446017",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T13:54:31.749Z",
    "customerOrderId": "OR-2603051354232446017",
    "failureCode": "NAME_NOT_MATCHED",
    "failureMessage": "Name verification failed. Please check the account details."
  },
  "createdAt": "2026-03-05T13:55:17.472Z"
}
```
```json Fund Processing
{
  "eventId": "EV-260305125748417",
  "entityId": "OR-2603051257371591318",
  "entityType": "order",
  "status": "fund_processing",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051257371591318",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T12:57:45.963Z",
    "customerOrderId": "OR-2603051257371591318"
  },
  "createdAt": "2026-03-05T12:58:30.300Z"
}
```

# Crypto Payin Order Events

## Order Statuses

| Event              | Entity Type | Status          | Description                                                                                                                 |
| ------------------ | ----------- | --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Payment Initiated  | Order       | `initiated`     | After confirming the order details, wallet address, and payment method selection, the order is created and awaiting payment |
| Payment Authorised | Order       | `asset_settled` | User has successfully completed the crypto payment                                                                          |
| Payment Expired    | Order       | `expired`       | The order expired before the user completed the payment                                                                     |

## Sample Webhook Payloads

```json Initiated
{
  "eventId": "EV-260305140224124",
  "entityId": "OR-2603051402100691567",
  "entityType": "order",
  "status": "initiated",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051402100691567",
    "type": "payin",
    "depositCurrency": "USDT",
    "depositAmount": 58,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 48.45,
    "walletAddress": "0x44E69A10637456E3ce4b5eCeb17b25a9127C1A82",
    "createdAt": "2026-03-05T14:02:19.931Z",
    "customerOrderId": "OR-2603051402100691567"
  },
  "createdAt": "2026-03-05T14:02:24.774Z"
}
```
```json Asset Settled
{
  "eventId": "EV-260305141724379",
  "entityId": "OR-2603051402100691567",
  "entityType": "order",
  "status": "asset_settled",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051402100691567",
    "type": "payin",
    "depositCurrency": "USDT",
    "depositAmount": 58,
    "withdrawCurrency": "EUR",
    "withdrawAmount": 48.45,
    "walletAddress": "0x44E69A10637456E3ce4b5eCeb17b25a9127C1A82",
    "createdAt": "2026-03-05T14:02:19.931Z",
    "customerOrderId": "OR-2603051402100691567"
  },
  "createdAt": "2026-03-05T14:17:24.172Z"
}
```
```json Expired
{
  "eventId": "EV-260305142000777",
  "entityId": "OR-2603051354232446017",
  "entityType": "order",
  "status": "expired",
  "user": {
    "userId": "UX-250910053447199",
    "firstName": "Aradhya",
    "lastName": "Verma",
    "country": "IN",
    "createdAt": "2025-09-10T05:34:47.983Z"
  },
  "order": {
    "orderId": "OR-2603051354232446017",
    "type": "payin",
    "depositCurrency": "EUR",
    "depositAmount": 150,
    "withdrawCurrency": "USD",
    "withdrawAmount": 174.22,
    "createdAt": "2026-03-05T13:54:31.749Z",
    "customerOrderId": "OR-2603051354232446017",
    "failureCode": "ORDER_EXPIRED",
    "failureMessage": "The order expired before payment was completed."
  },
  "createdAt": "2026-03-05T14:20:00.777Z"
}
```