[
{
"title":"Overview",
"link":"https://doc.chargebackhit.com/products/overview",
"text":"System overview to alert merchants to potential chargebacks before they occur, allowing the merchant to prevent a chargeback by issuing a refund instead.",
"imgSrc":"https://chargebackhit.com/wp-content/uploads/2022/04/benefits-2.svg"
}
,
{
"title":"Matching alerts",
"link":"https://doc.chargebackhit.com/integrate/matching_alerts/",
"text":"Internal logic for quick matching of alert data by the system in real-time.",
"imgSrc":"https://chargebackhit.com/wp-content/uploads/2022/03/icon-06.svg"
}
,
{
"title":"Integration steps",
"link":"https://doc.chargebackhit.com/integrate/integration_steps/",
"text":"Step-by-step instructions for the technical integration of the chargeback system.",
"imgSrc":"https://chargebackhit.com/wp-content/uploads/2022/04/benefits-1.svg"
}
]
Step-by-step instructions for the technical integration of the chargeback system
Overview
Chargeback
API
conform to representational state transfer (REST) design principles. They have predictable resource-oriented URLs, accept json-encoded request bodies, return JSON-encoded responses, use standard HTTP response codes and authentication.
All data sent to Chargebackhit with the upload API must be in a JSON string format that is capable of parsing back to JSON.
The main steps of the integration are:
Technical integration with Chargebackhit
Testing:
Sandbox account
Production account
Account settings
Steps 1-2 are recommended to be performed by the developer and step 3 by the account holder.
Receive an invitation to work email with account credentials for the merchant portal hub
Get API keys obtained from the “Settings” page
API keys - Public Key and Secret Key.
Create and provide notification URL for:
Sandbox account
Production account
You can also set and change URLs in the portal inside “Settings”.
The value of a signature is a base64-encoded value of hash function SHA-512. For the encryption key, the Secret Key will be applied. The following string will be used for signature data:
The signature allows the merchant system to verify the source and the integrity of the notification details transmitted between the Merchant and Chargebackhit.
The merchant will apply the Public Key and Secret Key to calculate the signature.
Headers of each request are to be placed in the following:
Parameter
Description
Example
Signature
Signature of the request allows verifying whether the request is genuine.
MjNiYjVj…ZhYmMxMzNiZDY=
Public Key
Unique identification, which will be shared at the moment of registration along with the Private Key.
The merchant is initially configured for working via a test environment and can check the Integration with a set of test alerts, which can be generated manually in the sandbox account in the alerts section:
The merchant can go live after integration is completed, and UAT testing is passed.
To address the alerts (refund, provide the response, etc.), firstly, we need to match the alerts to the exact transaction in the merchant’s database/CRM.
When integrating Chargebackhit into your workflows, you need to consider how long you can wait for a response from our system.
In an API-based service, timeouts define the total time available to process and respond to a request. By total time, we mean the time it takes for your request to get to our servers, be processed and responded to, and the response to return to your server.
The response time includes three main components:
Network latency: the delay in communicating over a network with our APIs.
Data enrichment: the time to get all the values for data enrichment. Since Chargebackhit has no control over third-party servers and data sources, response times may vary.
Matching Process: the time to process all rules and custom configurations in your account to create the full API response.
Response time of SLAs, for:
Inquiry - less than 2 seconds
Resolved - is irrelevant
Init-refund - is according to the rules (less than 24 hours)