Sign in

v1

latestOpenAPI 3.0.02026-07-242035712.0 MB
Card V2

Link Card And account

This web service allows to link card, account and cardholder.

Supports idempotency.

post/pws/v2/pws_link_card_acc/

Request body

actioninteger required
<p>action type :</p> <ul> <li class="docBullet">0 ==&gt; Link card and account or customer</li> <li class="docBullet">1 ==&gt; Unlink card and account or customer (Pending for development)</li> <li class="docBullet">2 ==&gt; Link card for replacement purpose</li> </ul>
api_call_unique_identifierstring required

Unique number that must be passed at each API request. Identifier to make each API request unique

client_idinteger required

Unique identifier for the client which Paymentology will provide at outset

tokeninteger required

Public token for the card

user_idstring

User Id of the Customer who triggered the API request.

remarksstring

Remarks for API request

old_tokeninteger
<p>Existing public token</p> <ul> <li>Linking existing token with new blank token will serve as replacement.</li> <li>Required when action = 2</li> </ul> <p>&nbsp;</p>
ac_idinteger
<p>Account id</p> <ul> <li>Client can link account and customer id during account creation itself and pass while linking with card.</li> <li>Required when action = 0</li> <li>Pass customer also id if an account is not linked to any customer yet</li> </ul>
ac_ext_refstring
<p>Account external reference</p> <ul> <li>Client can link ac_ext_ref/account and customer id during account creation itself and pass while linking with card.</li> <li>Required when action = 0</li> <li>Client should use unique ac_ext_ref while linking with card</li> <li>Pass customer id also if an ac_ext_ref/account is not linked to any customer yet</li> </ul>
cu_idinteger
<p>Customer id</p> <ul> <li>Client need to pass valid customer id otherwise linking with account or token will be skipped internally</li> <li>Client need to make sure account and customer id is already linked if not passed during link account card</li> </ul>
inherit_rulesinteger
<p>Inherit existing card rules. Based on value provide, it will either inherit existing rules or skip.&nbsp;</p> <ul> <li>0 ==&gt; Inherit</li> <li>1 ==&gt; Donot inherit</li> </ul> <p>Default value is 0 i.e. always inherit</p>

Example request

{
  "api_call_unique_identifier": "438574845790657485",
  "client_id": 760131,
  "token": 311012081,
  "old_token": 311012082,
  "ac_id": 479823917,
  "ac_ext_ref": "EXTREF",
  "cu_id": 12345
}

Response

Successful Response

Example response

{
  "header": {
    "error_desc": "success"
  },
  "body": {
    "token": 311012081,
    "ac_id": 479823917
  }
}