Application Status Change Webhook

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.

Field

Type

Description

Type

Integer

The type of webhook. Expected value: 12

Event Identifier

String

The name of the webhook. Expected value: ApplicationStatusChange

EventData

Object

Status

String

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

StatusValue

Integer

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

ChangeTime

DateTimeOffset

The date and time of the application's status change.

UnderwritingResultsURL

String

The merchant application URL.

UnderwritingDeclineReason

String

The underwriting decline reason.

MerchantApplicationId

String

The application id, seen in the application URL.

InfiniceptApplicationId

String

The unique identifier assigned by Infinicept.

ExternalApplicationId

String

The 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
     	 }
}