Zentact Documentation

Learn how to rapidly onboard merchants and facilitate payment initiation through your system with Zentact

API reference

Learn to easily integrate into the Zentact platform

Webhooks

Receve important updates about merchants and payments.

Quick start

Before you start using Zentact for Platforms, make sure to:

Contact our Sales Team to schedule the demo and figure it if it's the right fit for your business.
When we confirm that Zentact is a good fit for your use cases and the agreement is signed, our engineering team will configure your test environment along with your webhook endpoint and you will receive your Zentact test credentials, API and webhook keys.

Step 1: Initiate Merchant Onboarding

To start with your integration, initiate merchant account onboarding for sub-merchants in your platform.

The following code illustrates how to initate a registration with the minimal required data.

Request:

curl https://test.api.zentact.com/api/v1/merchant-accounts \
-H "x-API-key: YOUR-X-API-KEY" \
-H "content-type: application/json" \
-d '{
        "email": "admin@bigsmileinc.com",
        "businessName": "Big Smile, Inc.",
        "merchantReferenceId": "my-unique-merchant-id"
}'

Response:

{
  "status": "ok",
  "data": {
    "redirectUrl": "https://payments.dentalsolutions.com/signup?locale=en-US&invitation=tX8ehbYfpeVDIeEq03ZvEQ7O4dilHtM0&organization=org_ms0JZDbb4hOZ6Usd&organization_name=dental-solutions#sid=Jgcp4aK8aNhi4CeKOF3y5",
    "organizationId": "0d0fbcb3-396c-446b-b935-c7682092fb0a"
  }
}

See merchant accounts API documentation for additional information that can be pre-filled for merchants.

Once the merchant is onboarded Zentact will notify your backend via webhooks about the merchant status and after you'll be able to start checkouts.

Step 2: Create payment link

Initiate a card-not-present (Ecommerce) transaction for your newly onboarded merchant:

Request:

curl https://test.api.zentact.com/api/v1/checkout/start \
-H "x-API-key: YOUR-X-API-KEY" \
-H "content-type: application/json" \
-d '{
  "referenceId": "my-unique-transaction-id",
  "amount": 1299,
  "currency": "USD",
  "locale": "en-US",
  "merchantReferenceId": "my-unique-merchant-id"
}'

Response:

{
  "status": "ok",
  "data": {
    "checkoutUrl": "https://payments.dentalsolutions.site/checkout/#s=3WnlSSP9kgxXlZcoIasNe"
  }
}

Redirect your customer to the checkout url to complete the payment. Zentact will notify your backend about payment events via webhooks.

Zentact vs Adyen payment webhooks?

What's the difference between Adyen payment webhooks and Zentact's? Both allow you to receive payment status notifications, but Zentact offers additional details. These include split information, such as the fees charged, and the specific merchant account associated with each payment. Both notifications carry the reference ID submitted to Zentact for the payment.

Getting help

Need Assistance? We're Here for You!

Quick Solutions:

For immediate help, check out our FAQs and Knowledge Base. They are packed with answers to common questions and step-by-step guides.

Contact Support:

Can't find what you're looking for? Our support team is just an email away. Reach out to us at support@zentact.com for personalized assistance. We aim to respond within 24 hours.

Feedback and Suggestions:

Got ideas on how we can improve? We'd love to hear from you! Send your suggestions to feedback@zentact.com.

Emergency Support:

For urgent technical issues, contact our emergency support line at 1-855-ZENTACT. Available 24/7.