Application Status Change

New Accounts Webhooks

Summary

The ApplicationStatusChange webhook informs Payfacs of all status changes that occur on a merchant application, including systematic status changes and any manual status changes submitted by users. See the response schema and an example response below.


Webhook Configuration

To subscribe to, test, and/or delete a webhook, navigate to the Settings > Webhook Configuration page within your cobrand. See also New Accounts: Webhook Configuration.


Response Schema

See the field names and descriptions below.

FieldTypeDescription
TypeIntegerThe type of webhook. Expected value: 12
Event IdentifierStringThe name of the webhook. Expected value: ApplicationStatusChange
EventDataObject
StatusString

The application's status. Expected values include:

Incomplete
Approved
AcquirerReview
New Pend
Follow Up
Re Pend
Approved and Boarded
Declined
Processing
Pre-Generated
Withdrawn
Awaiting Digital Signature

StatusValueInteger

The integer value of the application's status. Expected values include:

0 = Incomplete
1 = Approved
2 = AcquirerReview
3 = New Pend
4 = Follow Up
5 = Re Pend
7 = Approved and Boarded
8 = Declined
11 = Processing
12 = Pre-Generated
14 = Withdrawn
15 = Awaiting Digital Signature

ChangeTimeDateTimeOffsetThe date and time of the application's status change.
UnderwritingResultsURLStringThe merchant application URL.
UnderwritingDeclineReasonStringThe underwriting decline reason.
MerchantApplicationIdStringThe application id, seen in the application URL.
InfiniceptApplicationIdStringThe unique identifier assigned by Infinicept.
ExternalApplicationIdStringThe unique identifier created by the Payfac when generating the merchant application via the API. If that value is left blank, this field displays as NULL.

Example Response

See an example of the webhook response for an application that updated to the Declined status.

{
 "Type":12,
 "EventIdentifier":"ApplicationStatusChange",
 "EventData": {
         "Status":"Declined",
         "StatusValue":8,
         "ChangeTime":"2025-05-05T18:38:36.4414653+00:00",
         "UnderwritingResultsURL":"https://dev.merchantapp.io/testwebhook/CoBrands/MerchantUW?applicationId=32840",
         "UnderwritingDeclineReason":"Example reason for declining the application",
         "MerchantApplicationId":32840,
         "InfiniceptApplicationId":"a9426a9f-5bc4-4ea6-8bd4-a6dde559c405",
         "ExternalApplicationId":null
     	 }
}

Did this page help you?