Zid Docs
Merchant APIPayment APIAppsThemes
Merchant APIPayment APIAppsThemes
Help Center
Slack
  1. Payment
  • 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

Direct Payment

Initiate session Request#

Overview#

This is the endpoint where the card information will be shared and a session is initiated. This request will be sent from the client side directly in the checkout and will not pass through ZidPay backend nor any data will be saved.
POST
{ProviderUrl}/tokens

Request Model#

Definition:#

PropertyTypeDescription
publishableApiKeystringMerchant public key
providerMerchantIdstringMerchant ID on provider side
namestringName on card
numberstringNumber on card
cvcstringCVC on card
monthstringExpiry month on card
yearstringExpiry year on card
Expected response from Payment Provider

Success Response Model #

PropertyTypeDescription
tokenstring
brandstringCard type,
types:
visa
master
mada
amex
fundingstringTypes:
Credit
debit
countrystringCard country
networkstringNetwork that the payment is going to be processed on,
Types:
visa
master
mada
amex
lastFourstringLast four digits

Failed Response Model #

PropertyTypeDescription
messagestring
errorsList< string >
Previous
Payment
Next
Embedded Payment
Built with