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, TICKET, VAULT.
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”.
Webhook – Authentication
The Webhook Authentication feature allows merchants to secure webhook requests by requiring signature verification. This ensures that webhook requests are authentic and protects against spoofing or replay attacks.
Valor supports webhook authentication using HMAC-SHA256 signatures.
Authentication Settings
In Settings → Webhook Configuration, a new option called Authentication is available.
This allows Merchants, ISOs, and ISVs to toggle authentication and generate a Secret Key.
Authentication – Enabled
When authentication is enabled:
- Valor automatically includes an HMAC signature and a timestamp in the headers of every webhook request.
- A new Secret Key will be generated when the feature is enabled.
- Merchants can copy the Secret Key from their webhook configuration in settings.
- Merchants can regenerate the secret key if needed.
Note: When regenerating, all client systems must update their configurations with the new key.
Authentication – Disabled
When authentication is disabled:
- Valor will stop including signatures in webhook requests.
- Client systems should be updated to stop expecting authentication headers.
Signature Generation (Valor Side)
Valor generates the webhook signature using the SHA256 algorithm with a secret key that is uniquely generated when webhook authentication is enabled.
The request payload (JSON) is stringified and concatenated with the current UTC timestamp, and the HMAC signature is computed for this value.
hash_hmac(
'sha256',
json_encode($rawPayload) . $timestamp,
$secret_key
);
Where:
- secret_key → Webhook secret key (from the Valor Dashboard).\
- rawPayload → Raw request body (exact JSON as sent).
- timestamp → Current UTC timestamp in ISO format.
Webhook Headers
Every authenticated webhook request includes:
{
"Valor-Timestamp": "2025-09-15T10:44:02Z",
"Valor-Signature": "28729c83f93c450e1b21c6167835fcb229f93ba3bc9a124a0fcd31f2e786cbdc"
}
Client-Side Validation
Extract Headers
- Valor-Signature
- Valor-Timestamp
Recompute Signature
- Concatenate the stringified request body + timestamp from the header.
- Compute HMAC-SHA256 using your webhook secret key.
Compare Signatures
- If computed_signature == Valor-Signature → Accept the request.
- Otherwise -> Reject as unauthenticated.
PHP
Python
Important Notes:
- Ensure client-side webhook implementation uses a compact JSON format.
- Languages like NodeJS and PHP use compact JSON formatting by default.
- Languages like Python do not, so the compact format must be enforced manually (as shown in the Python example above).
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
- Card Updater
- Transaction
- Batch Summary
- Recurring Failed
- Batch Detail Event
- Ticket Created
- Ticket Updated
- Ticket Deleted
- RECURRING BILLING SUCCESS
- RECURRING BILLING FAILED
Event identifier to the Webhooks payload
The client needs to be able to identify the type of data being sent to them without having to parse through
all the key-value pairs. There should be a single source of truth identifier for the data type.
Ex: {‘event’: ‘transaction’, ‘data’: {PAYLOAD}}.
Merchant Boarding
{
"event": "MERCHANT BOARDED",
"data": {
"user_Info": {
"UserId": 185466,
"FirstName": "sdfgvsdfsdfv",
"LastName": "dfbfdgbsdfbdf",
"EmailId": "[email protected]",
"MobileNo": "4254254252",
"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": 160641,
"dbaName": "dfsdfsdfsdfsedf",
"legalName": "button",
"legalAddress": "4444444444444",
"legalCity": "Long Island City",
"legalState": "Alabama",
"legalCountry": "US",
"legalZipCode": "11101",
"legalTimezone": "EST",
"TmsStatus": 0
},
"store_Info": {
"store_info": {
"StoreId": 208389,
"storeName": "dfsdfsdfsdfsedf#2",
"storeAddress": "4444444444444",
"storeCity": "Long Island City",
"storeState": "Alabama",
"storeCountry": "US",
"storeZipCode": "11101",
"storeTimezone": "EST",
"SupervisorName": "sdfgvsdfsdfv dfbfdgbsdfbdf",
"SupervisorContact": "4254254252",
"mcc": "744 - CHAMPAGNE PRODUCER",
"SupervisorEmail": "[email protected]",
"descriptors": null,
Merchant Delete
{
"event": "USER DELETE",
"data": {
"user_id": 186093,
"STATUS": "DELETED"
}
}
Merchant Status Changed
{
"event": "Merchant Status Changed",
"data": [
{
"mp_id": 9565,
"status": "ACTIVE"
}
]
}
Update Merchant Contact Info
{
"event": "MERCHANT CONTACT UPDATED",
"data": {
"mp_id" : 21548,
"first_name": "sarojini",
"last_name": "c",
"email": "[email protected]",
"mobile": "7305632694",
"user_name": "Merchantvt",
"dba_name": "Webhookisooo",
"legal_name": "DharshiniD",
"legal_address": "chennai",
"legal_city": "Pine Bush",
"legal_state": "30",
"legal_zipcode": "12566"
}
}
Store Creation
{
"event": "MERCHANT STORE ADDED",
"data": [
{
"mp_id" : 21548,
"StoreId": 41737,
"dbaName": "testmerchant",
"storeName": "testmerchant",
"storeAddress": "2 Jericho Plazza",
"storeCity": "Jericho",
"storeState": "30",
"storeCountry": "US",
"storeZipCode": "11753",
"SupervisorName": "Kevin Thomas",
"SupervisorContact": "5164696526",
"mcc_code": "4814",
"descriptors": null,
"SupervisorEmail": "[email protected]",
"storeTimezone": "EST",
"storeDBA": "testmerchant"
}
]
}
Store Details Update
{
"event": "MERCHANT STORE UPDATED",
"data": [
{
"mp_id" : 21548,
"StoreId": 9421,
"dbaName": "Rithish",
"storeName": "Jofra Archer",
"storeAddress": "Guindy",
"storeCity": "chennai",
"storeState": "48",
"storeCountry": "US",
"storeZipCode": "11250",
"SupervisorName": "Sahaya rithish",
"SupervisorContact": "9786301808",
"mcc_code": "0763",
"descriptors": "sahaya rithish",
"SupervisorEmail": "[email protected]",
"storeTimezone": "EST",
"storeDBA": "sahaya rithish"
}
]
}
Delete Store Info
{
"event": "MERCHANT STORE DELETED"
"data": {
"storeid": 208317,
"status": "deleted"
}
}
Add device Info
{
"event": "DEVICE ADDED",
"data": {
"store_id": 16675,
"storedetails": {
"epi_Info": {
"epi_details": {
"Mp_Id": 14197,
"epi": "2319928276",
"Device_model": 139,
"Device_name": "Virtual Terminal",
"Label": "VT #2",
"Description": null,
"processor": 6,
"processorInfo": {
"id": 72001,
"midDP": "RCTST00000506388",
"groupIdDP": "40001",
"termNoDP": "00000033",
"websiteDP": "kevin.com",
"EBTcash": 0,
"EBTfood": 0,
"EbtNoDP": "",
"customFeeChecked": 1,
"surchargeIndicator": 0,
"surchargePercentage": "3.500",
"mid_Dp6": "3124123412343124",
"tid_Dp6": "43254256",
"certificateNo": "3456435",
"c_nameDP3": 1,
"vendor": "",
"client_id": "",
"username": "",
"password": "",
"status": ""
},
"Status": "ACTIVE",
"key_group": null
}
}
}
}
}
Update Device Info
{
"event": "DEVICE UPDATED",
"data": {
"store_id": 209541,
"storedetails": {
"epi_Info": {
"epi_details": {
"Mp_Id": 161604,
"epi": "2319972317",
"Device_model": 139,
"Device_name": "Virtual Terminal",
"Label": "VT #1",
"Description": null,
"processor": 1,
"processorInfo": {
"id": 193413,
"mid": "887000003191",
"vNumber": "75021670",
"storeNo": "5999",
"termNo": "1515",
"binnumber": "999991",
"industry": "Retail",
"agentBank": "000000",
"chain": "111111",
"agent": "0001",
"surchargePercentage": "2.000",
"tid3": "611525",
"clientID": "45c4ddcc-feb1-4cb1-99f0-1ba71d6d8f69",
"c_name3": 1
},
"debit_share": "Rithish",
"Status": "ACTIVE",
"key_group": "chrome"
}
}
}
}
}
Delete Device Info
{
"event": "DEVICE DELETED",
"data": {
"store_id": 36724,
"epi_Info": {
"epi_id": "2319926670",
"STATUS": "DELETED"
}
}
}
Recurring Creation
{
"event": "RECURRING ADDED",
"data": {
"actual_amount": "100.00",
"start_date": "09/24/24",
"upcoming_date": "10/24/24",
"created_time": "2024-09-24 11:48:14",
"amount": "105.00",
"number_of_failed_attempt": 0,
"total_number_of_subscription": "6",
"descriptor": null,
"total_number_of_installment": null,
"upcoming_payment": "10/24/24",
"orderdescription": "",
"cardholder_name": "",
"masked_card": "XXXX1111",
"customer_name": "",
"customer_email": "",
"txamount": "0.00",
"phone_number": "() -",
"billing_customername": "Rasheth",
"billing_city": "Minneapolis",
"billing_state": "MN - Minnesota",
"billing_street_name": "Suite",
"billing_street_no": "No 23",
"billing_unit": "",
"billing_zipcode": "55455",
"shipping_customername": "Rasheth",
"shipping_city": "Minneapolis",
"shipping_state": "MN - Minnesota",
"shipping_street_name": "Suite",
"shipping_street_no": "No 23",
"shipping_unit": "",
"shipping_zipcode": "55455",
"charge_until": "6",
"orderId": null,
"recurring_type": 2,
"subscription_id": 21706,
"card_status": 0,
"total_charged_cash": "0",
"last_successful_processed_date": null,
"total_number_of_payments": 0,
"every_day_of_month": 24,
"subscription_status": 1,
"recurring_period": 2,
"payment_type": 1,
"day_in_field": 24,
"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,
"additional_input_label1": null,
"additional_input_label2": null,
"additional_input_1": null,
"additional_input_2": null
}
}
Recurring Update
{
"event": "RECURRING UPDATED",
"data": {
"actual_amount": "85.00",
"start_date": "09/24/24",
"upcoming_date": "10/24/24",
"created_time": "2024-09-24 10:29:57",
"amount": "90.78",
"number_of_failed_attempt": 0,
"total_number_of_subscription": "6",
"descriptor": null,
"total_number_of_installment": null,
"upcoming_payment": "10/24/24",
"orderdescription": "",
"cardholder_name": "",
"masked_card": "XXXX1111",
"customer_name": "",
"customer_email": "[email protected]",
"txamount": "90.78",
"phone_number": "(730) 563-2694",
"billing_customername": "dharshini",
"billing_city": "Lorado",
"billing_state": "VA - Virginia",
"billing_street_name": "brooklyn",
"billing_street_no": "52",
"billing_unit": "12",
"billing_zipcode": "25630",
"shipping_customername": "dharshini",
"shipping_city": "Lorado",
"shipping_state": "VA - Virginia",
"shipping_street_name": "brooklyn",
"shipping_street_no": "52",
"shipping_unit": "12",
"shipping_zipcode": "25630",
"charge_until": "6",
"orderId": null,
"recurring_type": 2,
"subscription_id": 21685,
"card_status": 1,
"total_charged_cash": "8500",
"last_successful_processed_date": "2024-09-24",
"total_number_of_payments": 1,
"every_day_of_month": 24,
"subscription_status": 1,
"recurring_period": 2,
"payment_type": 1,
"day_in_field": 24,
"company_name": "",
"invoicenumber": "",
"card_type": "DEBIT",
"card_scheme": "Visa",
"vault_id": 6757,
"epi": "2319925748",
"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,
"additional_input_label1": "",
"additional_input_label2": "",
"additional_input_1": "",
"additional_input_2": ""
}
}
Recurring Delete
{'event': 'Subcription Deleted', 'data': [{'subscription_id': 31477, 'status': 'Subcription Deleted'}]}
Add User Info
{
"event": "USER ADD",
"data": {
"userInfo": {
"basicInfo": {
"UserId": 65467,
"UserType_Id": 5,
"ParentId": 31483,
"FirstName": "Kevin",
"LastName": "Thomas",
"Role_Id": 11,
"MobileNo": "5164696526",
"EmailId": "[email protected]",
"UserType_Desc": "Operator",
"Status": 2,
"Is_Default": 0,
"userName": "kevintestmerchatnotp"
},
"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": {
"KevinDemoMerchant": {
"EPI: 2319914032": null,
"EPI: 2319914050": null,
"EPI: 2319926344": null,
"EPI: 2319928276": 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
{
"event": "USER UPDATED",
"data": {
"EmailId": "[email protected]",
"MobileNo": "5164696526",
"FirstName": "Kevinopt",
"LastName": "Thomas",
"Address": "",
"zipcode": "",
"State": "",
"city": "",
"userName": "kevinOperator",
"Cust_Name": "Kevin Roc Terminal+"
}
}
Delete User Info
{
"event": "USER DELETE",
"data": {
"user_id": 65467,
"STATUS": "DELETED"
}
}
Customer Info add to Vault
{
"event": "VAULT CUSTOMER CREATED",
"data": {
"customer_details_new": {
"id": 6763,
"merchant_id": 32581,
"customer_name": "Kavitha Saro",
"email": "[email protected]",
"phone": "7305632694",
"company": "ITC Grand chola",
"is_deleted": 0
},
"address_details": [
{
"is_same_address": true,
"address_label": "Home Address",
"billing_customer_name": "Kavitha Saro",
"billing_street_no": "010",
"billing_street_name": "megha",
"billing_unit": "#5",
"billing_zipcode": "12560",
"billing_city": "mount",
"billing_state": "AR - Arkansas",
"shipping_customer_name": "Kavitha Saro",
"shipping_street_no": "010",
"shipping_street_name": "megha",
"shipping_unit": "#5",
"shipping_zipcode": "12560",
"shipping_city": "mount",
"shipping_state": "AR - Arkansas"
}
],
"card_details": [
{
"vault_main_id": 6763,
"masked_pan": "XXXX1111",
"token": "87542BC0C0C01FCFE44C863B7246493CE5CEFA67",
"card_brand": "Visa",
"cardholder_name": "PLATINUM",
"card_type": "D"
}
]
}
}
Payment Profile add to Vault
{
"event": "VAULT CUSTOMER CARD ADDED",
"data": {
"vault_main_id": 3866,
"masked_pan": "XXXX1111",
"token": "BCFBBAB9640783657D9AB8FF0C0EBCCCB30394A5",
"card_brand": "Visa",
"cardholder_name": "ARTAN M",
"card_type": "D"
}
}
Update Vault Address Info
{
"event": "VAULT CUSTOMER ADDRESS UPDATED",
"data": {
"address_id": 0,
"vault_main_id": 6757,
"address_label": "village Address",
"billing_customer_name": "Kavitha Saro",
"billing_street_no": "010",
"billing_street_name": "megha",
"billing_unit": "#5",
"billing_city": "mount",
"billing_state": "AR - Arkansas",
"billing_zip": "12560",
"shipping_customer_name": "gayathri",
"shipping_street_no": "85",
"shipping_street_name": "saint",
"shipping_unit": "118",
"shipping_city": "Spring Dale",
"shipping_state": "",
"shipping_zip": "259865"
}
}
Delete Vault Payment Profile
{
"event": "VAULT CUSTOMER CARD DELETED",
"data": {
"userid": 35589,
"card_id": 7738,
"card_brand": "Discover",
"masked_pan": "XXXX6909"
}
}
Delete Vault Address Info
{
"event": "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": "",
"shipping_street_no": "",
"shipping_street_name": "",
"shipping_unit": "",
"shipping_zipcode": "",
"shipping_city": "",
"shipping_state": ""
}
}
Delete Vault Customer Info
{
"event": "VAULT CUSTOMER DELETED",
"data": {
"vault_id": "6475",
"Status": "DELETED"
}
}
ACH Sale
{
"event": "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
{
"event": "ACH RECURRING INTIATED",
"data": {
"uid": "2426496152",
"epi": "2319925748",
"account_number": "XXXX0000",
"routing_number": "XXXX0021",
"payee_name": "sales",
"account_type": "C",
"amount": 150.8,
"recurring_type": 1,
"start_from": "2024-09-20",
"number_subscription": 6,
"frequency_type": "4",
"userid": 57154,
"state_tax_amount": 5.8,
"city_tax_amount": 0,
"reduced_tax_amount": 0,
"username": "sarojini c",
"base_amount": 145,
"entry_class": "CCD",
"txn_type": "Debit"
}
}
ACH Void
{
"event": "ACH TRANSACTION VOIDED",
"data": {
"ach_uid": "669fab94634b0",
"epi_id": "2319936916"
}
}
ACH Validation
{
"event": "ACH VERIFICATION INTIATED",
"data": {
"status": true,
"message": "success",
"values": {
"status": true,
"content": {
"VerificationResponse": "Declined",
"AccountResponseCode": "RT00",
"CustomerResponseCode": "",
"bankName": "JPMORGAN CHASE BANK, NA"
}
},
"account_number": "XXXX0056",
"routing_number": "XXXX0021"
}
}
Card Updater
{
"event": "CardUpdater",
"data": {
"subscription_id": "35204",
"card_updater_response": null,
"card_updater_response_code": "0",
"upcoming_payment": "2024-07-30",
"epi": "2319936916",
"masked_card_no_new": "",
"masked_card_no_old": "6222 XXXX XXXX 0026",
"card_holder_name": "",
"card_brand": "CHINA UNION PAY",
"card_type": "CREDIT",
"card_category": "CLASSIC",
"customer_event": "CardUpdater",
"mp_id": "59499"
}
}
Transaction
{
"event": "transactions",
"data": {
"txn_id": 223074084646,
"epi_id": "2320051015",
"device_app_version": " v1.0.2",
"txn_type": "SALE",
"txn_type_code": 101,
"amount": 1000,
"tip_amount": 0,
"cashback_amount": 0,
"custom_fee_amount": 30,
"surcharge_fee_amount": 0,
"merchant_fee_amount": 0,
"tax_amount": 0,
"city_tax_amount": 0,
"state_tax_amount": 40,
"original_amount": 0,
"addtl_amount_2": 0,
"tran_no": 6,
"stan_no": "3160",
"invoice_no": "398479832432",
"batch_no": "19",
"masked_card_no": "4111 XXXX XXXX 1111",
"card_type": "DEBIT",
"card_scheme": "Visa",
"mcc": "5943",
"request_date": "2025-08-04",
"request_time": "09:12:51",
"response_date": "2025-08-04",
"response_time": "09:12:51",
"rrn": "521609414329",
"approval_code": "682701",
"response_code": "00",
"display_message": "",
"is_voided": 0,
"is_reversed": 0,
"settled_at": "2025-08-04 13:12:52",
"created_at": "2025-08-04 13:12:52",
"modified_at": "2025-08-04 13:12:54",
"request_recv_at": "2025-08-04 13:12:52",
"response_sent_at": "2025-08-04 13:12:52",
"batches_id": null,
"card_holder_name": "GHANI",
"store_number": null,
"agent_bank_number": null,
"net_amount": 1070,
"addtl_data_label1": "Employee No",
"addtl_data_value1": "1",
"addtl_data_label2": "Employee No",
"addtl_data_value2": "2",
"timezone": "EST",
"refunded_amount": 0,
"reduced_tax_amount": 0,
"food_balance_amount": null,
"food_amount": 0,
"ebt_approval_code": "",
"tip_fee_amount": 0,
"tax_fee_amount": 0,
"receipt_url": "https://rcpt-dev.valorpaytech.com:4430/?id=223074084646-521609414329-0-v2.0&type=mc",
"merchant_store_metadata": {
"merchant_name": "keerthanamerchant",
"store_name": "keerthanamerchant",
"mid": "RCTST0000050639",
"mp_id": "356737",
"store_id": "405157",
"cust_id": "13981"
},
"device_metadata": {
"device_id": "139",
"device_model": "Virtual Terminal",
"device_identifier": "3",
"ecomm_channel_identifier": 0,
"pos_entry_mode": "012",
"card_bin": "411111",
"message_type": "0200",
"host_response": "APPROVE",
"vt_username": "keerthanaa subash"
},
"transaction_flags_controls": {
"is_pin_txn": 0,
"is_partial_approved": 0,
"is_partial_auth_reversal": 0,
"is_auth_completed": 0,
"is_followup_txn": 0,
"is_ebt_voucher_txn": 0,
"is_non_cash_charge_txn": 1,
"is_deleted": "0",
"ignore_surcharge_calc": "",
"isv_user_name": ""
},
"amounts_fee_structure": {
"cash_discount_amount": 0,
"surcharge_label": "Card Difference",
"refunded_count": 0,
"tip_adjusted_count": 0
},
"reference_descriptive_data": {
"company_name": "",
"description": "new description",
"file_name": "",
"ref_txn_type": "CREDIT SALE",
"invoice_mode": "",
"invoicenumber": "398479832432",
"switch_error_code": "V0000",
"processor_response_code": "000"
},
"customer_info": {
"customer_phone_email": "[email protected]",
"customer_phone_number": "0897078989",
"customer_name": "new customer",
"phone": "0897078989",
"c2_phone": "0897078989",
"c2_id": "20834",
"c2_email": "[email protected]"
},
"vault_tokenization": {
"vault_id": "",
"vtToken": "A1C7CA96D0D3C6276A37324F3477DFD2588D9384",
"epage_id": ""
},
"additionl_label_data": {
"addtl_data_label1": "Employee No",
"addtl_data_value1": "1",
"addtl_data_label2": "Employee No",
"addtl_data_value2": "2",
"addtl_data_label3": "Employee No",
"addtl_data_value3": "3",
"addtl_data_label4": "Employee No",
"addtl_data_value4": "4",
"addtl_data_label5": "Employee No",
"addtl_data_value5": "5",
"addtl_data_label6": "Employee No",
"addtl_data_value6": "6",
"addtl_data_label7": "Employee No",
"addtl_data_value7": "7",
"addtl_data_label8": "Employee No",
"addtl_data_value8": "8",
"addtl_data_label9": "Employee No",
"addtl_data_value9": "9",
"addtl_data_label10": "Employee No",
"addtl_data_value10": "10",
"addtl_data_label11": "Employee No",
"addtl_data_value11": "11",
"addtl_data_label12": "Employee No",
"addtl_data_value12": "12",
"addtl_data_label13": "Employee No",
"addtl_data_value13": "13",
"addtl_data_label14": "Employee No",
"addtl_data_value14": "14",
"addtl_data_label15": "Employee No",
"addtl_data_value15": "15",
"addtl_data_label16": "Employee No",
"addtl_data_value16": "16",
"addtl_data_label17": "Employee No",
"addtl_data_value17": "17",
"addtl_data_label18": "Employee No",
"addtl_data_value18": "18",
"addtl_data_label19": "Employee No",
"addtl_data_value19": "19",
"addtl_data_label20": "Employee No",
"addtl_data_value20": "20",
"addtl_data_label21": "Employee No",
"addtl_data_value21": "21",
"addtl_data_label22": "Employee No",
"addtl_data_value22": "22",
"addtl_data_label23": "Employee No",
"addtl_data_value23": "23",
"addtl_data_label24": "Employee No",
"addtl_data_value24": "24",
"addtl_data_label25": "Employee No",
"addtl_data_value25": "25"
}
}
}
Batch Summary
{
"event": "batch_summary",
"data": {
"batches_id": 10184061,
"epi_id": "2320051015",
"batch_opened_at": "2025-07-11 13:12:43",
"batch_closed_at": "2025-07-11 13:12:49",
"batch_no": 13,
"total_debit_amount": 0,
"total_credit_amount": 1000,
"total_ebt_cash_amount": 0,
"total_ebt_food_amount": 0,
"total_ebt_voucher_amount": 0,
"total_gift_amount": 0,
"total_other_amount": 0,
"purchase_amount": 1000,
"void_amount": 0,
"refund_amount": 0,
"auth_amount": 0,
"ebt_cash_amount": 0,
"ebt_food_amount": 0,
"ebt_voucher_amount": 0,
"cash_purchase_amount": 0,
"cash_refund_amount": 0,
"cashback_amount": 0,
"tip_count": 0,
"tip_amount": 0,
"fee_count": 0,
"fee_amount": 0,
"surcharge_fee_amount": 0,
"merchant_fee_amount": 0,
"tax_amount": 0,
"city_tax_amount": 0,
"state_tax_amount": 0,
"created_at": "2025-07-11 13:12:49",
"modified_at": "2025-07-11 13:12:49",
"cash_withdrawal_amount": 0,
"vpid": 1,
"gift_add_value_amount": 0,
"gift_sale_amount": 0,
"gift_tip_amount": 0,
"reduced_tax_amount": 0,
"cash_discount_amount": 0,
"trigger_source": "Manual Batch",
"summary_url": "https:\/\/rcpt-dev.valorpaytech.com:4430\/batchrcpt\/?id=10184061-2320051015-13-0"
}
}
Recurring Failed
{
"event": "Recurring Failed",
"data": {
"message": "Recursive Payment of $708.63 is declined for subscription Id #34880, due to following reason Unknown Error",
"epi": "2319936916",
"subscriptionid": "34880",
"transactionamount": "$708.63",
"user_id": "79812"
}
}
Batch Detail Event
{
"event": "batch_detail",
"data": [
{
"txn_id": "223063815534",
"epi_id": "2320051015",
"device_app_version": " v1.0.2",
"txn_type": "SALE",
"txn_type_code": "101",
"amount": "1000",
"tip_amount": "0",
"cashback_amount": "0",
"custom_fee_amount": "0",
"surcharge_fee_amount": "0",
"merchant_fee_amount": "0",
"tax_amount": "0",
"city_tax_amount": "0",
"state_tax_amount": "0",
"original_amount": "0",
"addtl_amount_2": "0",
"tran_no": "1",
"stan_no": "1924",
"device_identifier": "3",
"invoice_no": "",
"batch_no": "13",
"masked_card_no": "4111 XXXX XXXX 1111",
"card_type": "DEBIT",
"card_scheme": "Visa",
"mcc": "5943",
"request_date": "2025-07-11",
"request_time": "09:12:41",
"response_date": "2025-07-11",
"response_time": "09:12:41",
"approval_code": "896003",
"response_code": "00",
"rrn": "519209177002",
"settled_at": "2025-07-11 13:12:41",
"created_at": "2025-07-11 13:12:41",
"modified_at": "2025-07-11 13:13:06",
"request_recv_at": "2025-07-11 13:12:41",
"response_sent_at": "2025-07-11 13:12:41",
"batches_id": null,
"store_number": null,
"agent_bank_number": null,
"timezone": "EST",
"refunded_amount": "0",
"reduced_tax_amount": "0",
"food_balance_amount": null,
"food_amount": "0",
"ebt_approval_code": "",
"tip_fee_amount": "0",
"is_voided": "0",
"is_reversed": "0",
"display_message": "",
"card_holder_name": "GHANI",
"net_amount": "1000",
"tax_fee_amount": "0",
"addtl_data_label1": "",
"addtl_data_value1": "",
"addtl_data_label2": "",
"addtl_data_value2": "",
"receipt_url": "https:\/\/rcpt-dev.valorpaytech.com:4430\/?id=223063815534-519209177002-0-v2.0&type=mc",
"trigger_source": "Manual Batch"
}
]
}
Ticket Created
{
"event": "TICKET CREATED",
"data": {
"ticket_id": 12970,
"created_by": 392902,
"merchant_name": "keerthanaa subash",
"epi": 2320042606,
"channel": "PORTAL",
"Description": "hardware issue found",
"status": "OPEN",
"Call_Me_Back_Number": "1414141414",
"last_txn_date": "2025-07-03 09:18:38",
"device_type": "Virtual Terminal"
}
}
Ticket Updated
{
"event": "TICKET UPDATED",
"data": {
"ticket_id": 12967,
"updated_by": 392902,
"merchant_name": "keerthanamerchant",
"epi": 2320042604,
"channel": "PORTAL",
"Description": "Any update on this issue .",
"Call_Me_Back_Number": "1414141414",
"last_txn_date": "2025-07-03 09:18:38",
"device_type": "Virtual Terminal",
"status": "OPEN"
}
}
Ticket Deleted
{
"event": "TICKET DELETED",
"data": {
"ticket_id": 12961,
"deleted_by": 392902,
"channel": "PORTAL"
}
}
RECURRING BILLING SUCCESS
{
"event": "RECURRING BILLING SUCCESS",
"data": {
"txn_id": 223074843183,
"epi_id": "2320051015",
"device_app_version": " v1.0.2",
"txn_type": "SALE",
"txn_type_code": 101,
"amount": 10000,
"tip_amount": 0,
"cashback_amount": 0,
"custom_fee_amount": 0,
"surcharge_fee_amount": 0,
"merchant_fee_amount": 0,
"tax_amount": 0,
"city_tax_amount": 0,
"state_tax_amount": 400,
"original_amount": 0,
"addtl_amount_2": 0,
"tran_no": 3,
"stan_no": "608920",
"invoice_no": "",
"batch_no": "23",
"masked_card_no": "4111 XXXX XXXX 1111",
"card_type": "DEBIT",
"card_scheme": "Visa",
"mcc": "5943",
"request_date": "2025-08-21",
"request_time": "08:44:40",
"response_date": "2025-08-21",
"response_time": "08:44:40",
"rrn": "523308919259",
"approval_code": "614626",
"response_code": "00",
"display_message": "",
"is_voided": 0,
"is_reversed": 0,
"settled_at": "2025-08-21 12:44:40",
"created_at": "2025-08-21 12:44:40",
"modified_at": "2025-08-21 12:44:42",
"request_recv_at": "2025-08-21 12:44:40",
"response_sent_at": "2025-08-21 12:44:40",
"batches_id": null,
"card_holder_name": "GHANI",
"store_number": null,
"agent_bank_number": null,
"net_amount": 10400,
"addtl_data_label1": "",
"addtl_data_value1": "",
"addtl_data_label2": "",
"addtl_data_value2": "",
"timezone": "EST",
"refunded_amount": 0,
"reduced_tax_amount": 0,
"food_balance_amount": null,
"food_amount": 0,
"ebt_approval_code": "",
"tip_fee_amount": 0,
"tax_fee_amount": 0,
"receipt_url": "https:\/\/rcpt-dev.valorpaytech.com:4430\/?id=223074843183-523308919259-0-v2.0&type=mc",
"subscription_id": "114539",
"subscription_status": "Active",
"subscriptionStartDate": "2025-08-21",
"first_payment": null,
"UpcomingPayment": "2025-09-21",
"total_number_of_payments": 3,
"recurring_customer_name": ""
}
}
RECURRING BILLING FAILED
{
"event": "RECURRING BILLING FAILED",
"data": {
"txn_id": 223074732120,
"epi_id": "2320042606",
"device_app_version": " v1.0.2",
"txn_type": "SALE",
"txn_type_code": 101,
"amount": 1000,
"tip_amount": 0,
"cashback_amount": 0,
"custom_fee_amount": 0,
"surcharge_fee_amount": 0,
"merchant_fee_amount": 0,
"tax_amount": 0,
"city_tax_amount": 0,
"state_tax_amount": 60,
"original_amount": 0,
"addtl_amount_2": 0,
"tran_no": 1,
"stan_no": "602372",
"invoice_no": "",
"batch_no": "24",
"masked_card_no": "",
"card_type": "",
"card_scheme": "",
"mcc": "5943",
"request_date": "2025-08-20",
"request_time": "02:27:35",
"response_date": "2025-08-20",
"response_time": "02:27:35",
"rrn": "",
"approval_code": null,
"response_code": "V1",
"display_message": "Invalid card token",
"is_voided": 0,
"is_reversed": 0,
"settled_at": "2025-08-20 06:27:35",
"created_at": "2025-08-20 06:27:35",
"modified_at": "2025-08-20 06:27:35",
"request_recv_at": "2025-08-20 06:27:35",
"response_sent_at": "2025-08-20 06:27:35",
"batches_id": null,
"card_holder_name": "Keerthana",
"store_number": null,
"agent_bank_number": null,
"net_amount": 1060,
"addtl_data_label1": "",
"addtl_data_value1": "",
"addtl_data_label2": "",
"addtl_data_value2": "",
"timezone": "EST",
"refunded_amount": 0,
"reduced_tax_amount": 0,
"food_balance_amount": null,
"food_amount": 0,
"ebt_approval_code": "",
"tip_fee_amount": 0,
"tax_fee_amount": 0,
"receipt_url": "",
"subscription_id": "114460",
"subscription_status": "Active",
"subscriptionStartDate": "2025-08-19",
"first_payment": null,
"UpcomingPayment": "2025-09-19",
"total_number_of_payments": 0,
"recurring_customer_name": ""
}
}