Skip to main content

Events

Unit uses Events to record important changes happening under your org. Once an event is created, it will be delivered to your application via a webhook call.

Our event types follow a specific structure: resource.event.

Each event includes an id field, which uniquely identifies the event instance, and a type field that identifies the type of the event instance.

Each event type includes a different set of attributes and relationships, relevant to that specific event.

Event attributes may contain a set of custom tags inherited from a related resource request.

account.closed#

Occurs when a Deposit Account is closed.

Example account.closed payload:
{  "data": [    {      "id": "269",      "type": "account.closed",      "attributes": {        "createdAt": "2021-04-13T07:40:43.813Z",        "closeReason": "ByCustomer",        "tags": {          "tag": "value"        }      },      "relationships": {        "account": {          "data": {            "id": "10004",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

account.reopened#

Occurs when a closed Deposit Account is reopened.

Example account.reopened payload:
{  "data": [    {      "id": "2724",      "type": "account.reopened",      "attributes": {        "createdAt": "2021-12-13T07:40:43.813Z"      },      "relationships": {        "account": {          "data": {            "id": "10004",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

account.frozen#

Occurs when a Deposit Account is frozen.

Example account.frozen payload:
{  "data": [    {      "id": "2354",      "type": "account.frozen",      "attributes": {        "createdAt": "2021-11-08T07:43:13.813Z",        "freezeReason": "Fraud",        "tags": {          "tag": "value"        }      },      "relationships": {        "account": {          "data": {            "id": "10004",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

account.unfrozen#

Occurs when a frozen Deposit Account is unfrozen.

Example account.unfrozen payload:
{  "data": [    {      "id": "2355",      "type": "account.unfrozen",      "attributes": {        "createdAt": "2021-12-08T07:43:13.813Z"      },      "relationships": {        "account": {          "data": {            "id": "10004",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

application.denied#

Occurs when an Application is denied.

Example application.denied payload:
{  "data": [    {      "id": "28",      "type": "application.denied",      "attributes": {        "createdAt": "2020-07-29T12:53:05.882Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "application": {          "data": {            "id": "52",            "type": "individualApplication"          }        }      }    }  ]}

application.pendingReview#

Occurs when an Application is in pendingReview state.

Example application.pendingReview payload:
{  "data": [    {      "id": "28",      "type": "application.pendingReview",      "attributes": {        "createdAt": "2020-07-29T12:53:05.882Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "application": {          "data": {            "id": "52",            "type": "individualApplication"          }        }      }    }  ]}

application.awaitingDocuments#

Occurs when additional Application Documents are required to approve an Application.

Example application.awaitingDocuments payload:
{  "data": [    {      "id": "3000",      "type": "application.awaitingDocuments",      "attributes": {        "createdAt": "2020-07-29T12:53:05.882Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "application": {          "data": {            "id": "87",            "type": "individualApplication"          }        }      }    }  ]}

authorization.created#

Occurs when an Authorization is created.

Example authorization.created payload:
{  "data": [    {      "id": "83",      "type": "authorization.created",      "attributes": {        "createdAt": "2021-02-21T07:31:18.692Z",        "amount": 1500,        "cardLast4Digits": "0019",        "merchant": {          "name": "Apple Inc.",          "type": "1000"        },        "recurring": false,        "tags": {          "tag": "value"        }      },      "relationships": {        "authorization": {          "data": {            "id": "98",            "type": "authorization"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "1",            "type": "card"          }        }      }    }  ]}

authorization.canceled#

Occurs when an Authorization is canceled.

Example authorization.created payload:
{  "data": [    {      "id": "83",      "type": "authorization.canceled",      "attributes": {        "createdAt": "2021-02-21T07:31:18.692Z",        "amount": 1500,        "cardLast4Digits": "0019",        "recurring": false,        "tags": {          "tag": "value"        }      },      "relationships": {        "authorization": {          "data": {            "id": "98",            "type": "authorization"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "1",            "type": "card"          }        }      }    }  ]}

authorization.amountChanged#

Occurs when an Authorization amount is changed.

Example authorization.created payload:
{  "data": [    {      "id": "83",      "type": "authorization.amountChanged",      "attributes": {        "createdAt": "2021-02-21T07:31:18.692Z",        "oldAmount": 1700,        "newAmount": 2000,        "tags": {          "tag": "value"        }      },      "relationships": {        "authorization": {          "data": {            "id": "98",            "type": "authorization"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "1",            "type": "card"          }        }      }    }  ]}

authorization.declined#

Occurs when an Authorization is declined.

Example authorization.created payload:
{  "data": [    {      "id": "83",      "type": "authorization.declined",      "attributes": {        "createdAt": "2021-02-21T07:31:18.692Z",        "amount": 1500,        "cardLast4Digits": "0019",        "recurring": false,        "reason": "InsufficientFunds",        "tags": {          "tag": "value"        }      },      "relationships": {        "authorization": {          "data": {            "id": "98",            "type": "authorization"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "1",            "type": "card"          }        }      }    }  ]}

authorizationRequest.approved#

Example authorizationRequest.approved payload:
{  "data": [    {      "id": "412",      "type": "authorizationRequest.approved",      "attributes": {        "createdAt": "2021-06-24T08:10:08.081Z",        "amount": 2000,        "status": "Approved",        "approvedAmount": 2000,        "partialApprovalAllowed": false,        "merchant": {          "name": "Merchant name",          "type": "6012"        },        "recurring": false,        "tags": {          "tag": "value"        }      },      "relationships": {        "authorizationRequest": {          "data": {            "id": "6",            "type": "purchaseAuthorizationRequest"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "7",            "type": "card"          }        }      }    }  ]}

authorizationRequest.declined#

Example authorizationRequest.declined payload:
{  "data": [    {      "id": "412",      "type": "authorizationRequest.declined",      "attributes": {        "createdAt": "2021-06-24T08:10:08.081Z",        "amount": 2000,        "status": "Declined",        "declineReason": "InsufficientFunds",        "partialApprovalAllowed": false,        "merchant": {          "name": "Merchant name",          "type": "6012"        },        "recurring": false,        "tags": {          "tag": "value"        }      },      "relationships": {        "authorizationRequest": {          "data": {            "id": "6",            "type": "purchaseAuthorizationRequest"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "7",            "type": "card"          }        }      }    }  ]}

authorizationRequest.pending (Purchase)#

Occurs when a Purchase related AuthorizationRequest is pending approval. See Programmatic authorization of card use

Example authorizationRequest.pending payload:
{  "data": [    {      "id": "412",      "type": "authorizationRequest.pending",      "attributes": {        "createdAt": "2021-06-24T08:10:08.081Z",        "amount": 2000,        "available": 150000,        "status": "Pending",        "partialApprovalAllowed": false,        "merchant": {          "name": "Merchant name",          "type": "6012"        },        "recurring": false,        "ecommerce": true,        "cardPresent": false,        "tags": {          "tag": "value"        }      },      "relationships": {        "authorizationRequest": {          "data": {            "id": "6",            "type": "purchaseAuthorizationRequest"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "7",            "type": "card"          }        }      }    }  ]}

authorizationRequest.pending (CardTransaction)#

Occurs when a CardTransaction related AuthorizationRequest is pending approval. See Programmatic authorization of card use

Note that the type of the authorization request under relationships here is capitalised (CardTransactionAuthorizationRequest), unlike the corresponding resource.

Example authorizationRequest.pending payload:
{  "data": [    {      "id": "415",      "type": "authorizationRequest.pending",      "attributes": {        "createdAt": "2021-06-24T08:10:08.081Z",        "amount": 2000,        "available": 150000,        "status": "Pending",        "partialApprovalAllowed": false,        "merchant": {          "name": "Merchant name",          "type": "6012"        },        "recurring": false,        "tags": {          "tag": "value"        }      },      "relationships": {        "authorizationRequest": {          "data": {            "id": "8",            "type": "CardTransactionAuthorizationRequest"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "7",            "type": "card"          }        }      }    }  ]}

authorizationRequest.pending (IIAS)#

Occurs when an IIAS related AuthorizationRequest is pending approval. See Programmatic authorization of card use

Example IIAS authorizationRequest.pending payload:
{  "data": [    {      "id": "412",      "type": "authorizationRequest.pending",      "attributes": {        "createdAt": "2021-06-24T08:10:08.081Z",        "amount": 2000,        "available": 150000,        "status": "Pending",        "partialApprovalAllowed": true,        "merchant": {          "name": "Merchant name",          "type": "6012"        },        "recurring": false,        "ecommerce": true,        "cardPresent": false,        "healthcareAmounts": {          "transitAmount": 0,          "prescriptionRXAmount": 0,          "visionOpticalAmount": 2000,          "clinicOtherQualifiedMedicalAmount": 0,          "dentalAmount": 0,          "totalHealthcareAmount": 2000        },        "tags": {          "tag": "value"        }      },      "relationships": {        "authorizationRequest": {          "data": {            "id": "6",            "type": "purchaseAuthorizationRequest"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        },        "card": {          "data": {            "id": "7",            "type": "card"          }        }      }    }  ]}

bulkPayments.failed#

Occurs when a Payment in bulk failed.

Example bulkPayments.failed payload:
{  "data": [    {      "id": "1",      "type": "bulkPayments.failed",      "attributes": {        "createdAt": "2021-01-02T13:38:28.223Z",        "tags": {          "tag": "value"        },        "index": "2",        "error": "{\"title\":\"User is not allowed to create a payment\",\"status\":\"403\"}",        "idempotencyKey": "1 2"      },      "relationships": {        "bulkPayments": {          "data": {            "id": "1",            "type": "bulkPayments"          }        }      }    }  ]}

bulkPayments.finished#

Occurs when a Payments bulk is finished.

Example bulkPayments.finished payload:
{  "data": [    {      "id": "1",      "type": "bulkPayments.finished",      "attributes": {        "createdAt": "2021-01-02T13:38:28.223Z"      },      "relationships": {        "bulkPayments": {          "data": {            "id": "1",            "type": "bulkPayments"          }        }      }    }  ]}

card.activated#

Occurs when a Card is activated for the first time.

Example card.activated payload:
{  "data": [    {      "id": "73",      "type": "card.activated",      "attributes": {        "createdAt": "2021-02-15T09:23:47.778Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "card": {          "data": {            "id": "6",            "type": "individualDebitCard"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

card.statusChanged#

Occurs when a Card status changes, excluding first time card activation (see card.activated).

Example card.statusChanged payload:
{  "data": [    {      "id": "74",      "type": "card.statusChanged",      "attributes": {        "createdAt": "2021-02-22T09:23:47.778Z",        "newStatus": "Lost",        "previousStatus": "Active",        "tags": {          "tag": "value"        }      },      "relationships": {        "card": {          "data": {            "id": "6",            "type": "individualDebitCard"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

checkDeposit.created#

Occurs when a Check Deposit is created.

Example checkDeposit.created payload:
{  "data": [    {      "id": "382",      "type": "checkDeposit.created",      "attributes": {        "createdAt": "2021-06-06T09:09:15.247Z",        "status": "AwaitingImages",        "tags": {          "tag": "value"        }      },      "relationships": {        "checkDeposit": {          "data": {            "id": "122",            "type": "checkDeposit"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

checkDeposit.pendingReview#

Occurs when a Check Deposit is pending review.

Example checkDeposit.pendingReview payload:
{  "data": [    {      "id": "376",      "type": "checkDeposit.pendingReview",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "AwaitingBackImage",        "tags": {          "tag": "value"        }      },      "relationships": {        "checkDeposit": {          "data": {            "id": "122",            "type": "checkDeposit"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

checkDeposit.pending#

Occurs when a Check Deposit is pending processing.

Example checkDeposit.pending payload:
{  "data": [    {      "id": "376",      "type": "checkDeposit.pending",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "PendingReview",        "tags": {          "tag": "value"        }      },      "relationships": {        "checkDeposit": {          "data": {            "id": "122",            "type": "checkDeposit"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

checkDeposit.rejected#

Occurs when a Check Deposit was rejected.

Example checkDeposit.rejected payload:
{  "data": [    {      "id": "411",      "type": "checkDeposit.rejected",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "Pending",        "reason": "Cannot read check. Please retake photo. Have steady hands, good lighting, and four check corners visible.",        "tags": {          "tag": "value"        }      },      "relationships": {        "checkDeposit": {          "data": {            "id": "122",            "type": "checkDeposit"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

checkDeposit.clearing#

Occurs when a Check Deposit is in the process of being cleared.

Example checkDeposit.clearing payload:
{  "data": [    {      "id": "376",      "type": "checkDeposit.clearing",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "Pending",        "tags": {          "tag": "value"        }      },      "relationships": {        "checkDeposit": {          "data": {            "id": "122",            "type": "checkDeposit"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

checkDeposit.sent#

Occurs when a Check Deposit was processed.

Example checkDeposit.sent payload:
{  "data": [    {      "id": "376",      "type": "checkDeposit.sent",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "Clearing",        "tags": {          "tag": "value"        }      },      "relationships": {        "checkDeposit": {          "data": {            "id": "122",            "type": "checkDeposit"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

checkDeposit.returned#

Occurs when a Check Deposit was returned.

Example checkDeposit.returned payload:
{  "data": [    {      "id": "376",      "type": "checkDeposit.returned",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "Sent",        "tags": {          "tag": "value"        }      },      "relationships": {        "checkDeposit": {          "data": {            "id": "122",            "type": "checkDeposit"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

customer.created#

Occurs when a new Customer is created.

Example customer.created payload:
{  "data": [    {      "id": "28",      "type": "customer.created",      "attributes": {        "createdAt": "2020-07-29T12:53:05.882Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "customer": {          "data": {            "id": "52",            "type": "individualCustomer"          }        },        "application": {          "data": {            "id": "52",            "type": "individualApplication"          }        }      }    }  ]}

customer.updated#

Occurs when a Customer is updated (whether by the org, or by Unit, in case the fields being updated are sensitive fields ).

Example customer.updated payload:
{  "data": [    {      "id": "9",      "type": "customer.updated",      "attributes": {        "createdAt": "2021-11-29T17:23:08.778Z",        "changes": {          "phone": {            "countryCode": "1",            "number": "1555555577"          },          "email": "richard2@piedpiper.com"        }      },      "relationships": {        "customer": {          "data": {            "id": "10000",            "type": "individualCustomer"          }        }      }    }  ]}

customer.archived#

Occurs when a Customer is archived.

Example customer.archived payload:
{  "data": [    {      "id": "1337",      "type": "customer.archived",      "attributes": {        "createdAt": "2021-04-13T07:40:43.813Z",        "archiveReason": "Inactive",        "tags": {          "tag": "value"        }      },      "relationships": {        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

declinedIncomingPayment.created#

Occurs when a Declined Incoming Payment is created.

Example declinedIncomingPayment.created payload:
{  "data": [    {      "id": "295",      "type": "declinedIncomingPayment.created",      "attributes": {        "createdAt": "2021-01-02T13:38:28.223Z",        "amount": 1000,        "direction": "Debit",        "reason": "NoAccount",        "paymentType": "AchPayment"      },      "relationships": {        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

dispute.created#

Occurs when a Dispute is created.

Example dispute.created payload:
{  "data": [    {      "id": "680",      "type": "dispute.created",      "attributes": {        "createdAt": "2022-01-01T14:08:19.040Z",        "amount": 500,        "description": "Disputed card transaction",        "source": "DebitCard",        "status": "InvestigationStarted"      },      "relationships": {        "dispute": {          "data": {            "id": "47",            "type": "dispute"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        },        "transaction": {          "data": {            "id": "142",            "type": "transaction"          }        }      }    }  ]}

dispute.statusChanged#

Occurs when a Dispute status changes.

Example dispute.statusChanged payload:
{  "data": [    {      "id": "687",      "type": "dispute.statusChanged",      "attributes": {        "createdAt": "2022-01-01T10:22:31.816Z",        "previousStatus": "InvestigationStarted",        "newStatus": "ResolvedWon"      },      "relationships": {        "dispute": {          "data": {            "id": "47",            "type": "dispute"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        },        "transaction": {          "data": {            "id": "142",            "type": "transaction"          }        }      }    }  ]}

document.approved#

Occurs when an Application Document is approved.

Example document.approved payload:
{  "data": [    {      "id": "193",      "type": "document.approved",      "attributes": {        "createdAt": "2020-11-09T09:05:49.999Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "document": {          "data": {            "id": "6",            "type": "document"          }        },        "application": {          "data": {            "id": "10009",            "type": "individualApplication"          }        }      }    }  ]}

document.rejected#

Occurs when an Application Document is rejected.

Example document.rejected payload:
{  "data": [    {      "id": "190",      "type": "document.rejected",      "attributes": {        "reason": "blurry image",        "reasonCode": "PoorQuality",        "createdAt": "2020-11-08T18:34:38.533Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "document": {          "data": {            "id": "6",            "type": "document"          }        },        "application": {          "data": {            "id": "10009",            "type": "individualApplication"          }        }      }    }  ]}

payment.created#

Occurs when an ACH Payment is successfully created with a specified status. This event does not fire for rejected payments, see payment.rejected instead.

Example payment.created payload:
{  "data": [    {      "id": "4132",      "type": "payment.created",      "attributes": {        "createdAt": "2021-12-27T12:12:39.133Z",        "status": "Pending",        "direction": "Credit",        "amount": 2500,        "tags": {          "tag": "value"        }      },      "relationships": {        "payment": {          "data": {            "id": "6",            "type": "payment"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

payment.clearing#

Occurs when an originated Debit ACH Payment was delivered to the ACH network, but the account was not credited yet.

Example payment.clearing payload:
{  "data": [    {      "id": "290",      "type": "payment.clearing",      "attributes": {        "previousStatus": "Pending",        "createdAt": "2020-11-08T18:34:38.533Z",        "direction": "Credit",        "amount": 2500,        "tags": {          "tag": "value"        }      },      "relationships": {        "payment": {          "data": {            "id": "6",            "type": "payment"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

payment.sent#

Occurs when an originated ACH Payment was processed by the ACH network.

Example payment.sent payload:
{  "data": [    {      "id": "291",      "type": "payment.sent",      "attributes": {        "previousStatus": "Pending",        "direction": "Credit",        "amount": 2500,        "createdAt": "2020-11-08T18:34:38.533Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "payment": {          "data": {            "id": "8",            "type": "payment"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

payment.rejected#

Occurs when an ACH Payment gets rejected for a specified reason.

Example payment.rejected payload:
{  "data": [    {      "id": "291",      "type": "payment.rejected",      "attributes": {        "createdAt": "2021-12-08T18:34:38.533Z",        "reason": "InsufficientFunds",        "direction": "Credit",        "amount": 2500,        "tags": {          "tag": "value"        }      },      "relationships": {        "payment": {          "data": {            "id": "6",            "type": "payment"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

payment.returned#

Occurs when a sent ACH Payment was returned by the ACH network or the receiving bank for a specified reason.

Example payment.returned payload:
{  "data": [    {      "id": "295",      "type": "payment.returned",      "attributes": {        "previousStatus": "Sent",        "createdAt": "2021-01-02T13:38:28.223Z",        "direction": "Credit",        "amount": 2500,        "tags": {          "tag": "value"        }      },      "relationships": {        "payment": {          "data": {            "id": "10",            "type": "payment"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

payment.canceled#

Occurs when a sent ACH Payment was canceled by the client / end-customer before being sent to the network.

Example payment.canceled payload:
{  "data": [    {      "id": "295",      "type": "payment.Canceled",      "attributes": {        "createdAt": "2021-01-02T13:38:28.223Z",        "direction": "Credit",        "amount": 2500,        "tags": {          "tag": "value"        }      },      "relationships": {        "payment": {          "data": {            "id": "10",            "type": "payment"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

payment.pendingReview#

Occurs when a sent ACH Payment is waiting to be manually reviewed, typically due to a high level of risk associated with that payment.

Example payment.pendingReview payload:
{  "data": [    {      "id": "295",      "type": "payment.pendingReview",      "attributes": {        "createdAt": "2021-01-02T13:38:28.223Z",        "direction": "Credit",        "amount": 2500,        "tags": {          "tag": "value"        }      },      "relationships": {        "payment": {          "data": {            "id": "10",            "type": "payment"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

recurringPayment.created#

Occurs when a recurring payment is created.

Example recurringPayment.created payload:
{  "data": [    {      "id": "360",      "type": "recurringPayment.created",      "attributes": {        "createdAt": "2022-06-25T14:27:41.093Z",        "status": "Active",        "amount": 200,        "tags": {          "test": "test"        },        "nextScheduledAction": "2022-07-05"      },      "relationships": {        "recurringPayment": {          "data": {            "id": "4",            "type": "recurringPayment"          }        },        "account": {          "data": {            "id": "10002",            "type": "account"          }        },        "customer": {          "data": {            "id": "10004",            "type": "customer"          }        }      }    }  ]}

recurringPayment.statusChanged#

Occurs when a recurring payment status has been changed. See Recurring Payment Statuses.

Example recurringPayment.statusChanged payload:
{  "data": [    {      "id": "359",      "type": "recurringPayment.statusChanged",      "attributes": {        "createdAt": "2022-06-25T14:23:26.785Z",        "previousStatus": "Completed",        "status": "Active",        "amount": 200,        "numberOfPayments": 2,        "tags": {}      },      "relationships": {        "recurringPayment": {          "data": {            "id": "2",            "type": "recurringPayment"          }        },        "account": {          "data": {            "id": "10002",            "type": "account"          }        },        "customer": {          "data": {            "id": "10004",            "type": "customer"          }        }      }    }  ]}

recurringPayment.failed#

Occurs when a payment creation from a recurring payment has been failed.

Example recurringPayment.created payload:
{  "data": [    {      "id": "100",      "type": "recurringPayment.failed",      "attributes": {        "createdAt": "2022-06-11T11:40:58.708Z",        "amount": 200,        "tags": {},        "error": "{\"title\":\"User is not allowed to create a payment\",\"status\":\"403\"}"      },      "relationships": {        "recurringPayment": {          "data": {            "id": "24",            "type": "recurringPayment"          }        },        "account": {          "data": {            "id": "10002",            "type": "account"          }        }      }    }  ]}

statements.created#

Occurs when all Statements were created for the previous month.

Example statements.created payload:
{  "data": [    {      "id": "241",      "type": "statements.created",      "attributes": {        "createdAt": "2021-03-01T00:16:28.911Z",        "period": "2021-02",        "tags": {          "tag": "value"        }      }    }  ]}

transaction.created#

Occurs when a Transaction is created.

Example transaction.created payload:
{  "data": [    {      "id": "34",      "type": "transaction.created",      "attributes": {        "summary": "Funding",        "direction": "Debit",        "amount": 2500,        "balance": 689305,        "createdAt": "2020-07-30T09:17:21.593Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "transaction": {          "data": {            "type": "receivedAchTransaction",            "id": "10001"          }        },        "account": {          "data": {            "id": "1000",            "type": "account"          }        },        "customer": {          "data": {            "id": "1",            "type": "customer"          }        },        "payment": {          "data": {            "id": "515",            "type": "payment"          }        }      }    }  ]}

transaction.updated#

Occurs when a PurchaseTransaction, AtmTransaction, or CardTransaction is updated with the interchange amount, calculated at the end of each day.

Example transaction.created payload:
{  "data": [    {      "id": "33266",      "type": "transaction.updated",      "attributes": {        "createdAt": "2020-07-30T09:17:21.593Z",        "interchange": 2.43      },      "relationships": {        "transaction": {          "data": {            "type": "purchase",            "id": "45123"          }        }      }    }  ]}

receivedPayment.created#

Occurs when a Received Payment is created.

Example receivedPayment.created payload:
{  "data": [    {      "id": "1337",      "type": "receivedPayment.created",      "attributes": {        "createdAt": "2021-06-06T09:09:15.247Z",        "status": "Pending",        "type": "Ach",        "amount": 500000,        "completionDate": "2020-07-30",        "companyName": "UBER LTD",        "counterpartyRoutingNumber": "051402372",        "description": "paycheck",        "traceNumber": "123456789123456",        "secCode": "PPD",        "addenda": "",        "tags": {          "tag": "value"        }      },      "relationships": {        "receivedPayment": {          "data": {            "id": "122",            "type": "receivedPayment"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

receivedPayment.advanced#

Occurs when a Received Payment is advanced.

Example receivedPayment.advanced payload:
{  "data": [    {      "id": "411",      "type": "receivedPayment.advanced",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "Pending",        "wasAdvanced": true,        "tags": {          "tag": "value"        }      },      "relationships": {        "receivedPayment": {          "data": {            "id": "1337",            "type": "receivedPayment"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

receivedPayment.completed#

Occurs when a Received Payment is completed.

Example receivedPayment.completed payload:
{  "data": [    {      "id": "411",      "type": "receivedPayment.completed",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "Advanced",        "wasAdvanced": true,        "tags": {          "tag": "value"        }      },      "relationships": {        "receivedPayment": {          "data": {            "id": "1337",            "type": "receivedPayment"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

receivedPayment.returned#

Occurs when a Received Payment is returned.

Example receivedPayment.returned payload:
{  "data": [    {      "id": "411",      "type": "receivedPayment.returned",      "attributes": {        "createdAt": "2021-06-06T07:21:39.509Z",        "previousStatus": "Pending",        "wasAdvanced": true,        "tags": {          "tag": "value"        }      },      "relationships": {        "receivedPayment": {          "data": {            "id": "1337",            "type": "receivedPayment"          }        },        "account": {          "data": {            "id": "10001",            "type": "account"          }        },        "customer": {          "data": {            "id": "10000",            "type": "customer"          }        }      }    }  ]}

chargeback.created#

Occurs when a Chargeback is successfully created.

Example payment.created payload:
{  "data": [    {      "id": "1337",      "type": "chargeback.created",      "attributes": {        "createdAt": "2021-12-27T12:12:39.133Z",        "amount": 5000,        "description": "chargeback for payments issued on 12/1/2022",        "tags": {          "tag": "value"        }      },      "relationships": {        "chargeback": {          "data": {            "id": "669",            "type": "chargeback"          }        },        "account": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        },        "counterpartyAccount": {          "data": {            "id": "10010",            "type": "account"          }        },        "transaction": {          "data": {            "id": "10010",            "type": "transaction"          }        }      }    }  ]}

reward.sent#

Occurs when a Reward is successfully sent to an end customer.

Example reward.sent payload:
{  "data": [    {      "id": "9173",      "type": "reward.sent",      "attributes": {        "createdAt": "2021-04-02T12:12:39.133Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "reward": {          "data": {            "id": "42",            "type": "reward"          }        },        "fundingAccount": {          "data": {            "id": "10009",            "type": "account"          }        },        "receivingAccount": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

reward.rejected#

Occurs when a Reward creation request is rejected (typically due to account status or availability of funds).

Example reward.rejected payload:
{  "data": [    {      "id": "8246",      "type": "reward.rejected",      "attributes": {        "createdAt": "2021-04-02T12:14:39.133Z",        "tags": {          "tag": "value"        }      },      "relationships": {        "reward": {          "data": {            "id": "42",            "type": "reward"          }        },        "fundingAccount": {          "data": {            "id": "10009",            "type": "account"          }        },        "receivingAccount": {          "data": {            "id": "10009",            "type": "account"          }        },        "customer": {          "data": {            "id": "10002",            "type": "customer"          }        }      }    }  ]}

Get by Id#

Get an event resource by id.

VerbGET
Urlhttps://api.s.unit.sh/events/{id}
Required Scopeevents

Response#

Response is a JSON:API document.

200 OK#

FieldTypeDescription
dataEventThe requested resource after the operation was completed.
curl -X GET 'https://api.s.unit.sh/events/10' \-H "Authorization: Bearer ${TOKEN}"

List#

List event resources. Paging can be applied.

VerbGET
Urlhttps://api.s.unit.sh/events
Required Scopeevents

Query Parameters#

NameTypeDefaultDescription
page[limit]integer100Optional. Maximum number of resources that will be returned. Maximum is 1000 resources. See Pagination.
page[offset]integer0Optional. Number of resources to skip. See Pagination.
filter[type][]string(empty)Optional. Filter Events by Event type.
curl -X GET 'https://api.s.unit.sh/events?page[limit]=20&page[offset]=10' \-H "Authorization: Bearer ${TOKEN}"

Response#

Response is a JSON:API document.

200 OK#

FieldTypeDescription
dataArray of EventArray of event resources.
Example Response:
{  "data": [    {      "id": "231",      "type": "customer.created",      "attributes": {        "createdAt": "2021-03-15T12:20:39.216Z"      },      "relationships": {        "customer": {          "data": {            "id": "10004",            "type": "businessCustomer"          }        }      }    },    {      "id": "230",      "type": "transaction.created",      "attributes": {        "createdAt": "2021-03-15T07:49:09.089Z",        "amount": 10000,        "direction": "Credit",        "summary": "Wire to Jane Smith"      },      "relationships": {        "account": {          "data": {            "id": "10005",            "type": "account"          }        },        "transaction": {          "data": {            "id": "189",            "type": "wireTransaction"          }        },        "customer": {          "data": {            "id": "10000",            "type": "individualCustomer"          }        }      }    }  ]}

Fire Event#

Resend a previously published webhook event.

VerbPOST
Urlhttps://api.s.unit.sh/events/{eventId}
Required Scopeevents-write
Example Request:
curl -X POST 'https://api.s.unit.sh/events/78'-H 'Content-Type: application/vnd.api+json'-H 'Authorization: Bearer ${TOKEN}'--data-raw '{}'