Zid Docs
Merchant APIPayment APIAppsThemes
Merchant APIPayment APIAppsThemes
Help Center
Slack
  1. Payment API
  • Merchant Activation
  • Submitting
  • Webhooks
    • Link Merchant Event
    • Payment Paid Event
    • Refund Event
  • Payment
    • Direct Payment
    • Embedded Payment
  • ApplePay
    • ApplePay Checkout
    • On Payment Authorized
    • Register ApplePay Domain
      POST
    • On Providing Merchant Validation
      POST
    • Execute Payment Request
      POST
  1. Payment API

Merchant Activation

Overview#

This is the process of a merchant activating payments through ZidPay with your system, This happens by having a special login page for Zid merchants on the provider side to verify their accounts and for the provider to share the Public/Secret Keys of the merchant with ZidPay Link Merchant webhook.
Upon redirection to the provider's login page, ZidPay will append the "storeId" parameter to the URL, which is the unique identifier for the merchant at Zid. After the onboarding of the merchant happens at the provider side (a new merchant account / record is created), we expect the merchant to be redirected back to the Zid portal. The redirection URLs are specified below:
For testing / staging environment:
https://testing-web.zid.sa/account/settings/payment-options/other?ThirdPartyId={thirdPartyProviderId}&status={status}
For production environment:
https://web.zid.sa/account/settings/payment-options/other?ThirdPartyId={thirdPartyProviderId}&status={status}
Whereas thirdPartyProviderId is the ID of the payment service provider, and status indicates the status of the onboarding and can be one of two possible values: “success” or “failure”
image.png
Next
Submitting
Built with