Client VCC Decisioning

Client VCC Decisioning is designed to allow ConnexPay clients with proper permissions to have the ability to decision authorizations directed to them, rather than Connexpay decisioning the authorizations.

What is Client VCC Decisioning?

Client VCC Decisioning uses a synchronous webhook, to allow clients to approve or decline authorization requests in real time. This functionality is only available for clients using Central or MVB Bank.

Client VCC Decisioning Setup

As a client, you will need to provide a webhook endpoint that can be added within your account settings. You can navigate to your account settings by logging into Bridge and clicking the gear icon in the upper right-hand corner, then clicking on VCC Decisioning (this section will only be visible if the permission has been granted to your account) within the account settings options. When a card is used to make a purchase, we will send the authorization request to the provided endpoint for your authorization decision.

Within the account settings, you will also need to choose your timeout handling. If we don't receive your response within 2 seconds, we will use the timeout handling selection to automatically decision the authorization. Your options will be to automatically decline the authorization or run the authorization through the standard ConnexPay process.

Additionally, you will be required to create a username and password in your account settings that we will use for basic authentication on the webhook. This username and password will be sent in the header of the request, so that you can verify our identity.

Prior to submitting this data, we will need to open up access and confirm connectivity to your provided endpoint.

Authorization requests

We will send the authorization request to your provided endpoint.

FieldTypeDescription
amountdecimalAmount of transaction
cardGuidstringUnique token that represents the issued card brand and type
currencyCodestringType of currency
networkstringVisa or Mastercard
cardAcceptorNamestringCard acceptor merchant name
cardAcceptorMidstringUnique identifier for acceptor merchant
cardAcceptorMccstringMerchant category code (MCC)
cardAcceptorCitystringCard acceptor city
cardAcceptorStatestringCard acceptor state
cardAcceptorZipstringCard acceptor zip
cardAcceptorCountrystringCard acceptor country
availableBalancedecimalAmount remaining on the card after the specific auth event
{
  "amount": 132.23,
  "cardguid": "ss322d33-1sd3-32sd-d2dd-21s32ddwdss233",
  "currencyCode": "USD",
  "network": "VISA",
  "cardAcceptorName": "SPIRIT AIR VISA",
  "cardAcceptorMid": "1234567890",
  "cardAcceptorMcc": "3260",
  "cardAcceptorCity": "ALPHARETTA",
  "cardAcceptorState": "GA",
  "cardAcceptorZip": "30005",
  "cardAcceptorCountry": "US",
  "availableBalance": 232.23
}

Authorization response

Our webhook accepts JSON responses with the following parameters:

FieldTypeDescription
approvedbooleanField will require a true or false response
{
  "approved": false,
}
{
  "approved": true,
}