PApaymentology
Card

Get pin

Changed on

This web service provides the ability to retrieve a PIN for a card/token. The encrypted pin is returned, or the PIN is sent via SMS to the cardholder.Note: The sending of the PIN via SMS requires that a valid mobile number be included during the card create process

post/pws/pws_get_pin/

Request

  • Base URL
    https://api.uat.paymentology.com/ppws/api
  • URL
    https://api.uat.paymentology.com/ppws/api/pws/pws_get_pin/
  • Auth
    none declared

Request body

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

delivery_methodinteger required
<p>pin delivery method:</p> <ul> <li class="docBullet"> <p>0==&gt;returns encrypted pin in response</p> </li> <li class="docBullet"> <p>1==&gt; SMS plain pin to card holder (sms will be sent to ch_mobile field of pws_create_card web service, if provided during create card else error message will be returned).</p> </li> </ul> <p>Note : if the mobile number has not been provided at create card stage, then it can be updated using pws_card_holder_edit. mobile number format must be 00 (country code ) phone number or + (country code) phone number</p>
tokeninteger required

Public token for the card

user_idstring

User Id of the Customer who triggered the API request.

remarksstring

Remarks for API request

Example request

{
  "api_call_unique_identifier": "438574845790657485",
  "client_id": 760131,
  "token": 311012081
}

Response

Successful Response

Example response

{
  "header": {
    "error_desc": "success"
  },
  "body": {
    "epin": "58461C15E75A61EA3D334ACD352E8363"
  }
}

Changes