Cards API
    Cards API
    • Introduction
    • API Usage Instructions
    • Platform URL's
    • API Specification
    • Authentication
    • Steps to Generate a Secure Signature
    • Callback Parameters and Template
    • Merchant
      • Information
        GET
      • Program Details
        GET
    • Cards
      • KYC Requirements
      • Apply Card
        • Apply
        • Binding
      • Information
        • CardDetails
        • PinDetails
        • CardBalance
        • Single Card Transactions
        • All Cards Transactions
        • Countries
        • Towns
      • Top Up
        • Estimate Card TopUp Fee
        • TopUp
        • TopUp Status
      • Actions
        • Freeze
        • UnFreeze
        • Cancellation
        • SetPin
    • Webhooks
      • Callback notification
      • Kycstatus result callback notification
      • Createcard result callback notification
      • Recharge callback notification
      • Operation callback notification
      • Consume result callback notification
      • Fee callback notification
      • Refund callback notification
      • Bank card 3DS verification

    Steps to Generate a Secure Signature

    This section explains how to generate a signature for a request using asymmetric encryption. Both ArthaCard and the merchant must exchange public keys, which will be used for validating requests.
    Public Key: Exchanged between both parties for validation.
    Private Key: Retained securely for yourself.

    Steps to Create the Signature#

    1. Pick and Sort
    Gather all the request header information and the request body.
    Exclude the signature field and any fields with empty values.
    Sort all the fields by parameter name in ascending ASCII order.
    2. Combine
    Form a new string using the sorted parameters with the format <parameter name>=<parameter value>, separating each parameter pair with an & symbol.
    The combined string will be signed using the private key.
    3. Invoke Signature Function
    Use the SHA256WithRSA signature function along with the private key to sign the combined string. The RSA key should be 1024 bits in length.
    Encode the resulting signature in base64 format.
    Insert the base64-encoded signature value into the signature field in the request header.
    Modified at 2025-02-18 09:45:24
    Previous
    Authentication
    Next
    Callback Parameters and Template
    Built with