Introduction
A Webhook is a functionality to send data to a Webhook URL. It facilitates the transmission of data to the specified Webhook endpoint using HTTP requests.
The Webhook feature facilitates merchants and ISOs to promptly receive notifications about events occurring with their accounts. It should allow the user to configure the Webhook URL.
"Reach out to [email protected] to enable Webhook support on your account."
Webhook – Valid URL
The ISO must provide a valid URL for the webhook. If the merchant provides an incorrect URL, it will be deemed invalid.
Ex: https://vpuat.valorpaytech.com
In ISO, Webhook URL column should accept the valid URL and duplicate URL should also be accepted.
In ISO, Webhook URL column should accept the valid URL and shows pop up as “WEBHOOK URL UPDATED”.
Webhook – Invalid URL
In ISO, Webhook URL column should not accept the invalid URL.
Ex: https://valorpaytech.com/404page
In ISO, Webhook URL column should not accept the invalid URL and shows pop up as “WEBHOOK URL VERIFICATION UPDATED”.
Webhook – Merchant
In ISO Boarding, if a webhook option is enabled in integration, Add Customer full board page and in the settings of webhook option and a webhook option will also display in the merchant login of settings. And it will display as ISO Configured settings.
Webhook – Settings
In Settings, a webhook entity and action are enabled to verify and update the webhook URL and it will get notified to the merchant webhook URL.
The entity is Merchant, User, Devices, Transaction, Recurring, Settlement, Card updater.
The Action are ADD, UPDATE, DELETE, AUTHCAPTURE, AUTHDECLINED, VOIDED, RETURN, APPROVED, FAILED, SUMMARY, DETAIL.
Merchant – Valid URL
In Merchant, Webhook URL column should accept the valid URL and duplicate URL should also be accepted.
In Merchant, Webhook URL column should accept the valid URL and shows pop up as “WEBHOOK URL UPDATED”.
Merchant – Invalid URL
In Merchant, Webhook URL column should not accept the invalid URL.
In Merchant, Webhook URL column should not accept the invalid URL and shows pop up as “WEBHOOK URL VERIFICATION UPDATED”.
Following the webhook events
- Merchant Boarding
- Merchant Delete
- Merchant Status Changed
- Update Merchant Contact Info
- Store Creation
- Store Details Update
- Delete Store Info
- Add device Info
- Update Device Info
- Delete Device Info
- Recurring Creation
- Recurring Update
- Recurring Delete
- Add User Info
- Update User Info
- Delete User Info
- Customer Info add to Vault
- Payment Profile add to Vault
- Update Vault Address Info
- Delete Vault Payment Profile
- Delete Vault Address Info
- Delete Vault Customer Info
- ACH Sale
- ACH Recurring
- ACH Void
- ACH Validation
Merchant Boarding
{
"user_id": 185235,
"action": "MERCHANT BOARDED",
"data": {
"user_Info": {
"UserId": 185235,
"FirstName": "dddddddddddddd",
"LastName": "44444",
"EmailId": "[email protected]",
"MobileNo": "0444444444",
"ParentId": 8077,
"CustID": 1306,
"Address": "4444444444444",
"city": "Long Island City",
"state": "New York",
"zipcode": "11101"
},
"module_Info": {
"1-User Management": null,
"3-Transactions": null,
"15-Device Management": null,
"17-Engage My Customers": null,
"18-Promotions": null,
"19-Valor Shield RT": null,
"20-Contact Us": null,
"25-My Tickets": null,
"29-Vault": null
},
"merchant_Info": {
"MpId": 160581,
"dbaName": "FFFFFFFFFFFFFFFFFFFFFFF",
"legalName": "Authenticate button",
"legalAddress": "4444444444444",
"legalCity": "Long Island City",
"legalState": "Alabama",
"legalCountry": "US",
"legalZipCode": "11101",
"legalTimezone": "EST",
"TmsStatus": 0
},
"store_Info": {
"STORE :: 208323": {
"StoreId": 208323,
"storeName": "FFFFFFFFFFFFFFFFFFFFFFF",
"storeAddress": "4444444444444",
"storeCity": "Long Island City",
"storeState": "Alabama",
"storeCountry": "US",
"storeZipCode": "11101",
"storeTimezone": "EST",
"SupervisorName": "dddddddddddddd 44444",
"SupervisorContact": "0444444444",
"mcc": "6300 - INSURANCE SALES'> UNDERWRITING AND PREMIUMS",
"SupervisorEmail": "[email protected]",
"descriptors": null,
"epi_Info": {
"EPI :: 2319971696": {
"Mp_Id": 160581,
"epi": "2319971696",
"Device_model": 130,
"Device_name": "VL100",
"Label": "VL100#1",
"Description": null,
"processor": 2,
"processorInfo": {
"id": 191781,
"groupId": "40001",
"midFD": "1111111",
"termNoFD": "000015",
"website": "ww.abc.com",
"EBTcash": 0,
"EBTfood": 0,
"EbtNoFD": "",
"surchargeIndicator": 0,
"surchargePercentage": "4.444",
"midFD1": "",
"groupId1": "",
"termNoFD1": "",
"website1": "",
"EBTcash1": 0,
"EBTfood1": 0,
"EbtNoFD1": "",
"tidFD3": "",
"clientID_FD": "",
"tidFD4": "",
"clientID_FD4": "",
"location_FD4": "",
"integration_authFD4": "",
"integration_pwdFD4": "",
"c_nameFD3": 1,
"vendor": "",
"client_id": "",
"username": "",
"password": "",
"status": ""
},
"debit_share": null,
"Status": "ACTIVE"
}
}
}
}
}
}
Merchant Delete
{
"user_id": 38232,
"action": "USER DELETE",
"data": {
"user_id": 38232,
"STATUS": "DELETED"
}
}
Merchant Status Changed
{
"user_id": 19866,
"action": "Merchant Status Changed",
"data": {
"mp_id": "19866",
"Status": "DEACTIVATE"
}
}
Update Merchant Contact Info
{
"user_id": "7280",
"data": {
"first_name": "Axiondad",
"last_name": "epiiii",
"email": "[email protected]",
"mobile": "8248377678",
"user_name": "[email protected]",
"dba_name": "Axion",
"legal_name": "Axionh",
"legal_address": "chnai751",
"legal_city": "ASTORIA",
"legal_state": "49",
"legal_zipcode": "11105"
},
"action": "MERCHANT CONTACT UPDATED"
}
Store Creation
{
"user_id": 37163,
"data": [
{
"StoreId": 208317,
"dbaName": "seenicardck",
"storeName": "dgdffdf",
"storeAddress": "46gvjfdgfdgvndfgvn",
"storeCity": "Long Island City",
"storeState": "30",
"storeCountry": "US",
"storeZipCode": "11101",
"SupervisorName": "dfdffdsdf",
"SupervisorContact": "5464444464",
"mcc_code": "1520",
"descriptors": null,
"SupervisorEmail": "[email protected]",
"storeTimezone": "EST",
"storeDBA": "seenicardck"
}
],
"action": "MERCHANT STORE ADDED",
"epi_id": null
}
Store Details Update
{
"user_id": 37163,
"data": [
{
"StoreId": 208314,
"dbaName": "seenicardck",
"storeName": "dgdffdf",
"storeAddress": "46gvjfdgfdgvndfgvnjm",
"storeCity": "Long Island City",
"storeState": "30",
"storeCountry": "US",
"storeZipCode": "11101",
"SupervisorName": "dfdffdsdf",
"SupervisorContact": "5464444464",
"mcc_code": "1520",
"descriptors": null,
"SupervisorEmail": "[email protected]",
"storeTimezone": "EST",
"storeDBA": "seenicardck"
}
],
"action": "MERCHANT STORE UPDATED"
}
Delete Store Info
{
"user_id": 37163,
"data": {
"storeid": 208317,
"status": "deleted"
},
"action": "MERCHANT STORE DELETED"
}
Add device Info
{
"user_id": 37163,
"action": "DEVICE ADDED",
"epi_id": 2319971693,
"data": {
"store_id": 208314,
"storedetails": {
"epi_Info": {
"epi_details": {
"Mp_Id": 19091,
"epi": "2319971693",
"Device_model": 139,
"Device_name": "Virtual Terminal",
"Label": "VT #1",
"Description": null,
"processor": 2,
"processorInfo": {
"id": 191775,
"groupId": "40001",
"midFD": "555WWW5",
"termNoFD": "00001",
"website": "ww.abc.com",
"surchargePercentage": "6.366",
"c_nameFD3": 1
},
"Status": "ACTIVE",
"key_group": null
}
}
}
}
}
Update Device Info
{
"user_id": 37163,
"action": "MERCHANT DEVICE UPDATED",
"epi_id": "2319971693",
"data": {
"store_id": 208314,
"storedetails": {
"epi_Info": {
"epi_details": {
"Mp_Id": 19091,
"epi": "2319971693",
"Device_model": 139,
"Device_name": "Virtual Terminal",
"Label": "VT #1",
"Description": null,
"processor": 2,
"processorInfo": {
"id": 191775,
"midFD": "555WWW54",
"groupId": "40001",
"termNoFD": "00001",
"website": "ww.abc.com",
"surchargePercentage": "6.366",
"c_nameFD3": 1
},
"Status": "ACTIVE",
"key_group": ""
}
}
}
}
}
Delete Device Info
{
"user_id": 9486,
"action": "DEVICE DELETED",
"epi_id": "2201001130",
"data": {
"store_id": 7449,
"epi_Info": {
"epi_id": "2201001130",
"STATUS": "DELETED"
}
}
}
Recurring Creation
{
"user_id": 37831,
"action": "RECURRING ADDED",
"data": {
"actual_amount": "400.00",
"start_date": "06/04/24",
"upcoming_date": "07/04/24",
"created_time": "2024-06-04 07:57:58",
"amount": "432.00",
"number_of_failed_attempt": 0,
"total_number_of_subscription": "6",
"descriptor": null,
"total_number_of_installment": null,
"upcoming_payment": "07/04/24",
"orderdescription": "",
"cardholder_name": "",
"masked_card": "XXXX1111",
"customer_name": "seenicardbrand Authenticate button",
"customer_email": "",
"txamount": "0.00",
"phone_number": "() -",
"billing_customername": "seenicardbrand Authenticate button",
"billing_city": "Long Island City",
"billing_state": "NY - New York",
"billing_street_name": "114444444",
"billing_street_no": "4444444444444",
"billing_unit": "",
"billing_zipcode": "11101",
"shipping_customername": "seenicardbrand Authenticate button",
"shipping_city": "Long Island City",
"shipping_state": "NY - New York",
"shipping_street_name": "114444444",
"shipping_street_no": "4444444444444",
"shipping_unit": "",
"shipping_zipcode": "11101",
"charge_until": "6",
"orderId": null,
"recurring_type": 2,
"subscription_id": 24962,
"card_status": 1,
"total_charged_cash": "40000",
"last_successful_processed_date": null,
"total_number_of_payments": 0,
"every_day_of_month": 4,
"subscription_status": 1,
"recurring_period": 2,
"payment_type": 1,
"day_in_field": 4,
"company_name": null,
"invoicenumber": null,
"card_type": null,
"card_scheme": null,
"vault_id": null,
"epi": null,
"is_skip": 0,
"is_postpone": 0,
"last_skipped_date": null,
"number_of_skip": 0,
"last_postpone_date": null,
"number_of_postpone": 0,
"last_resume_date": null,
"total_skip": 0,
"total_postpone": 0,
"total_resume": 0,
"remaining_balance": 1
}
}
Recurring Update
{
"user_id": 8527,
"action": "RECURRING UPDATED",
"data": {
"actual_amount": "5.55",
"start_date": "05/30/24",
"upcoming_date": "06/30/24",
"created_time": "2024-05-30 06:55:10",
"amount": "6.08",
"number_of_failed_attempt": 0,
"total_number_of_subscription": null,
"descriptor": null,
"total_number_of_installment": "2",
"upcoming_payment": "06/30/24",
"orderdescription": "",
"cardholder_name": "",
"masked_card": "XXXX1111",
"customer_name": "dddddddddddddd Authenticate button",
"customer_email": "",
"txamount": "6.14",
"phone_number": "() -",
"billing_customername": "dddddddddddddd Authenticate button",
"billing_city": "Long Island City",
"billing_state": "NJ - New Jersey",
"billing_street_name": "114444444",
"billing_street_no": "11111",
"billing_unit": "",
"billing_zipcode": "11101",
"shipping_customername": "dddddddddddddd Authenticate button",
"shipping_city": "Long Island City",
"shipping_state": "NJ - New Jersey",
"shipping_street_name": "114444444",
"shipping_street_no": "11111",
"shipping_unit": "",
"shipping_zipcode": "11101",
"charge_until": "2",
"orderId": null,
"recurring_type": 2,
"subscription_id": 24794,
"card_status": 1,
"total_charged_cash": "555",
"last_successful_processed_date": "2024-05-30",
"total_number_of_payments": 1,
"every_day_of_month": 30,
"subscription_status": 1,
"recurring_period": 2,
"payment_type": 2,
"day_in_field": 30,
"company_name": "",
"invoicenumber": "",
"card_type": "DEBIT",
"card_scheme": "Visa",
"vault_id": null,
"epi": "2229168738",
"is_skip": 0,
"is_postpone": 0,
"last_skipped_date": null,
"number_of_skip": 0,
"last_postpone_date": null,
"number_of_postpone": 0,
"last_resume_date": null,
"total_skip": 0,
"total_postpone": 0,
"total_resume": 0,
"remaining_balance": 1
}
}
Recurring Delete
{
"merchant_userid": 8527,
"action": "RECURRING DEACTIVATED",
"data": [
{
"subscription_id": 24794,
"subscription_status": "RECURRING DEACTIVATED"
}
]
}
Add User Info
{
"merchant_userid": 8527,
"action": "USER ADD",
"data": {
"userInfo": {
"basicInfo": {
"UserId": 42449,
"UserType_Id": 5,
"ParentId": 8527,
"FirstName": "dvhdivhf",
"LastName": "hicsvhdv",
"Role_Id": 11,
"MobileNo": "5569686966",
"EmailId": "[email protected]",
"UserType_Desc": "Operator",
"Status": 2,
"Is_Default": 0,
"userName": "sdfsdfydsuf"
},
"processorDetails": {
"acquirer_id": null
},
"billingType": "",
"selectedfeatures": {
"Allow Refund transaction": null,
"Allow Addcash transaction": null,
"Recurring payment conversion": null,
"Void Transaction": null,
"Refund Transaction": null,
"Open Batch": null
},
"advance_Control": {
"subiso2merchant": {
"EPI: 2125941632": null,
"EPI: 2229168738": null,
"EPI: 2229205519": null
}
},
"moduleInfo": {
"3-Transactions": null,
"14-Virtual Terminal": null,
"17-Engage My Customers": null,
"18-Promotions": null,
"20-Contact Us": null,
"25-My Tickets": null,
"29-Vault": null
}
}
}
}
Update User Info
{
"userid": "42428",
"action": "USER UPDATED",
"data": {
"EmailId": "[email protected]",
"MobileNo": "6558555205",
"FirstName": "sdvjfgfhsd",
"LastName": "gjvfgfhf",
"Address": "",
"zipcode": "",
"State": "",
"city": "",
"userName": "aufhefe",
"Cust_Name": "hazik1"
}
}
Delete User Info
{
"user_id": 185250,
"action": "USER DELETE",
"data": {
"user_id": 185250,
"STATUS": "DELETED"
}
}
Customer Info add to Vault
{
"user_id": 36627,
"action": "VAULT CUSTOMER CREATED",
"data": {
"customer_details_new": {
"id": 5775,
"merchant_id": 18900,
"customer_name": "hhhhhhhhhh",
"email": "",
"phone": "",
"company": "",
"is_deleted": 0
},
"address_details": [
{
"is_same_address": true,
"address_label": "Home Address",
"billing_customer_name": "hhhhhhhhhh",
"billing_street_no": "",
"billing_street_name": "",
"billing_unit": "",
"billing_zipcode": "",
"billing_city": "",
"billing_state": "",
"shipping_customer_name": "hhhhhhhhhh",
"shipping_street_no": "",
"shipping_street_name": "",
"shipping_unit": "",
"shipping_zipcode": "",
"shipping_city": "",
"shipping_state": ""
}
],
"card_details": [
{
"vault_main_id": 5775,
"masked_pan": "XXXX1111",
"token": "2D5C3C2B40121098B170B785916FFD3622BD6A6E",
"card_brand": "Visa",
"cardholder_name": "",
"card_type": "D"
}
]
}
}
Payment Profile add to Vault
{
"user_id": 9486,
"action": "VAULT CUSTOMER CARD ADDED",
"data": {
"vault_main_id": 5580,
"masked_pan": "XXXX8431",
"token": "0179BBA56094D5B2EE4FCC00A9073903E15B7762",
"card_brand": "Amex",
"cardholder_name": "",
"card_type": "C"
}
}
Update Vault Address Info
{
"user_id": 9486,
"action": "VAULT CUSTOMER ADDRESS UPDATED",
"data": {
"address_id": 28509,
"vault_main_id": 5580,
"address_label": "Office Address",
"billing_customer_name": "sssssxso",
"billing_street_no": "ssss",
"billing_street_name": "",
"billing_unit": "",
"billing_city": "",
"billing_state": "",
"billing_zip": "",
"shipping_customer_name": "sssssxso",
"shipping_street_no": "ssss",
"shipping_street_name": "",
"shipping_unit": "",
"shipping_city": "",
"shipping_state": "",
"shipping_zip": ""
}
}
Delete Vault Payment Profile
{
"user_id": 9486,
"action": "VAULT CUSTOMER CARD DELETED",
"data": {
"userid": 9486,
"card_id": 5334,
"card_brand": "Amex",
"masked_pan": "XXXX8431"
}
}
Delete Vault Address Info
{
"user_id": 9486,
"action": "VAULT CUSTOMER ADDRESS DELETED",
"data": {
"is_same_address": true,
"address_label": "Home Address",
"billing_customer_name": "",
"billing_street_no": "",
"billing_street_name": "",
"billing_unit": "",
"billing_zipcode": "",
"billing_city": "",
"billing_state": "",
"shipping_customer_name": "seeni",
"shipping_street_no": "",
"shipping_street_name": "",
"shipping_unit": "coast",
"shipping_zipcode": "",
"shipping_city": "",
"shipping_state": ""
}
}
Delete Vault Customer Info
{
"user_id": 9486,
"action": "VAULT CUSTOMER DELETED",
"data": {
"vault_id": "5580",
"Status": "DELETED"
}
}
ACH Sale
{
"user_id": 36627,
"action": "ACH SALE INTIATED",
"data": {
"uid": "2419297317",
"epi": "2319918526",
"account_number": "XXXX0000",
"routing_number": "XXXX0021",
"payee_name": "dddddddddddddd Authent",
"account_type": "C",
"amount": "104.00",
"state_tax_amount": 4,
"city_tax_amount": 0,
"reduced_tax_amount": 0,
"userid": 36627,
"username": "ACH Merchant",
"base_amount": "100.00"
}
}
ACH Recurring
{
"user_id": 36627,
"action": "ACH RECURRING INTIATED",
"data": {
"uid": "2419284549",
"epi": "2319918526",
"account_number": "XXXX0000",
"routing_number": "XXXX0021",
"payee_name": "iiiiiii",
"account_type": "C",
"amount": "218.40",
"recurring_type": 1,
"start_from": "2024-07-10",
"number_subscription": 6,
"frequency_type": "4",
"userid": 36627,
"state_tax_amount": 8.4,
"city_tax_amount": 0,
"reduced_tax_amount": 0,
"username": "ACH Merchant",
"base_amount": "210.00"
}
}
ACH Void
{
"user_id": 36627,
"action": "ACH TRANSACTION VOIDED",
"epi": "2319918526",
"data": {
"ach_uid": "668e1fc4d7cf2"
}
}
ACH Validation
{
"user_id": 36627,
"action": "ACH VERIFICATION INTIATED",
"data": {
"status": true,
"message": "success",
"values": {
"status": true,
"content": {
"VerificationResponse": "Declined",
"AccountResponseCode": "RT00",
"CustomerResponseCode": "",
"bankName": "JPMORGAN CHASE BANK, NA"
}
},
"account_number": "XXXX0000",
"routing_number": "XXXX0021"
}
}