Summary

Updates the underwriting status of a merchant application by ID.

In the case of updating multiple applications, a single request per application is required. As a best practice, please allow for 500ms of time between each request. Passing multiple MerchantApplicationId values per request is not supported.

PUT https://merchantapp.io/{cobrandslug}/api/v1/Underwriting/UpdateUnderwritingStatus

Headers

Header	Required/Optional	Type	Description
X-AuthenticationKeyId	Required	String	The API key id used to authenticate your request to Infinicept. API keys are managed within your New Accounts cobrand.
X-AuthenticationKeyValue	Required	String	The API key value used to authenticate your request to Infinicept. API keys are managed within your New Accounts cobrand.

Path Parameters

Parameter	Required/Optional	Type	Description
cobrandSlug	Required	String	The unique cobrand identifier assigned by Infinicept. This value is available on the Settings page within your cobrand in the Account Settings > Url Slug field.

Request Body

{
  "MerchantApplicationId": 12345,
  "UnderwritingStatus": "Withdrawn"
}

The following table describes the properties accepted in the request.

Properties	Required/Optional	Type	Description
MerchantApplicationId	Required	Integer	The ID of the merchant application to update.
UnderwritingStatus	Required	Enum	The new status to apply. Values can be provided in the request as strings (e.g., Withdrawn) or enum value (e.g., 14). Values include: 0 = Incomplete 1 = Approved 2 = AcquirerReview 3 = NewPend 4 = FollowUp 5 = RePend 7 = ApprovedAndBoarded 8= Declined 11 = Processing 12 = PreGenerated 14 = Withdrawn NOTE: In the response, the enum value of the status is returned.

Properties

Required/Optional

Type

Description

MerchantApplicationId

Required

Integer

The ID of the merchant application to update.

UnderwritingStatus

Required

Enum

The new status to apply. Values can be provided in the request as strings (e.g., Withdrawn) or enum value (e.g., 14). Values include:

0 = Incomplete
1 = Approved
2 = AcquirerReview
3 = NewPend
4 = FollowUp
5 = RePend
7 = ApprovedAndBoarded
8= Declined
11 = Processing
12 = PreGenerated
14 = Withdrawn

NOTE: In the response, the enum value of the status is returned.

Status-Specific Action - Declined

Setting the UnderwritingStatus to Declined automatically sets DeclinedDate in the Standard Report export to the current UTC timestamp.

Response Codes

Success (200) OK

A successful response returns the MerchantApplicationId, ResponseCode, PreviousUnderwritingStatus, and NewUnderwritingStatus, allowing you to review the change.

NOTE: In the response, the enum value of the PreviousUnderwritingStatus and NewUnderwritingStatus is returned. See the table above for the list of statuses and corresponding enum values.

{
  "MerchantApplicationId": 12345,
  "ResponseCode": "Success",
  "PreviousUnderwritingStatus": 12,
  "NewUnderwritingStatus": 14
}

Code	Description	Message
400	Bad Request	Invalid request, payload, or cobrand
401	Unauthorized	Invalid or missing API credentials
404	Not Found	Merchant application not found or does not belong to the tenant