PIN

Set PIN

This API allows you to sets the PIN for a cardholder in the system.

Endpoint

GET {{baseUrl}}/issuing/api/:version/card/setpin

Description

Sets the personal identification number (PIN) for a cardholder within the system. This API allows the cardholder to securely define their PIN, enabling safe access for ATM withdrawals and POS transactions.

Request Path Parameters

Parameter	Type	Required	Description
version	string	Yes	API version number

Request Headers

Parameter	Type	Required	Description
x-api-key	string	Yes	Shared X-API key
x-product-id	string	Yes	Shared ProductID
x-cardholder-id	string	Yes	Cardholder Identification
x-wallet-id	string	Yes	Wallet Identification
x-card-id	string	Yes	Card Identification
x-request-id	string	Yes	Idempotency key for request tracking
Content-Type	string	Yes	Must be application/json

Request Example

cURL

curl --location --request GET \
--url '{{baseUrl}}/issuing/api/:version/card/setpin' \
--header 'x-api-key: {{Shared X-API key}}' \
--header 'x-product-id: {{Shared ProductID}}' \
--header 'x-cardholder-id: {{CardholderID}}' \
--header 'x-wallet-id: {{WalletID}}' \
--header 'x-card-id: {{CardID}}' \
--header 'x-request-id: {{IdempotencyKey}}' \
--header 'Content-Type: application/json' \

Response Example

200: Success

{
  "status": "Success",
  "message": "Set PIN URL fetched successfully.",
  "code": 200,
  "data": [
    {
      "set_pin_url": "URL"
    }
  ]
}

400: Error

{
  "code": 400,
  "message": "Error Message",
  "status": "error"
}

Reset PIN

This API is used to reset PIN for a cardholder in the system.

Endpoint

GET {{baseUrl}}/issuing/api/:version/card/resetpin

Description

Resets the personal identification number (PIN) for a cardholder within the system. This API allows the cardholder to securely reset their PIN, ensuring continued protection for ATM withdrawals and POS transactions.

Request Path Parameters

Parameter	Type	Required	Description
version	string	Yes	API version number

Request Headers

Parameter	Type	Required	Description
x-api-key	string	Yes	Shared X-API key
x-product-id	string	Yes	Shared ProductID
x-cardholder-id	string	Yes	Cardholder Identification
x-wallet-id	string	Yes	Wallet Identification
x-card-id	string	Yes	Card Identification
x-request-id	string	Yes	Idempotency key for request tracking
Content-Type	string	Yes	Must be application/json

Request Example

cURL

curl --location --request GET \
--url '{{baseUrl}}/issuing/api/:version/card/resetpin' \
--header 'x-api-key: {{Shared X-API key}}' \
--header 'x-product-id: {{Shared ProductID}}' \
--header 'x-cardholder-id: {{CardholderID}}' \
--header 'x-wallet-id: {{WalletID}}' \
--header 'x-card-id: {{CardID}}' \
--header 'x-request-id: {{IdempotencyKey}}' \
--header 'Content-Type: application/json' \

Response Example

200: Success

{
  "status": "Success",
  "message": "Reset PIN URL fetched successfully.",
  "code": 200,
  "data": [
    {
      "set_pin_url": "URL"
    }
  ]
}

400: Error

{
  "code": 400,
  "message": "Error Message",
  "status": "error"
}

Change PIN

This API is used to change PIN for a cardholder in the system.

Endpoint

GET {{baseUrl}}/issuing/api/:version/card/changepin

Description

Changes the personal identification number (PIN) for a cardholder within the issuing platform. This API allows the cardholder to securely update their existing PIN, ensuring continued protection for ATM withdrawals and POS transactions.

Request Path Parameters

Parameter	Type	Required	Description
version	string	Yes	API version number

Request Headers

Parameter	Type	Required	Description
x-api-key	string	Yes	Shared X-API key
x-product-id	string	Yes	Shared ProductID
x-cardholder-id	string	Yes	Cardholder Identification
x-wallet-id	string	Yes	Wallet Identification
x-card-id	string	Yes	Card Identification
x-request-id	string	Yes	Idempotency key for request tracking
Content-Type	string	Yes	Must be application/json

Request Example

cURL

curl --location --request GET \
--url '{{baseUrl}}/issuing/api/:version/card/changepin' \
--header 'x-api-key: {{Shared X-API key}}' \
--header 'x-product-id: {{Shared ProductID}}' \
--header 'x-cardholder-id: {{CardholderID}}' \
--header 'x-wallet-id: {{WalletID}}' \
--header 'x-card-id: {{CardID}}' \
--header 'x-request-id: {{IdempotencyKey}}' \
--header 'Content-Type: application/json' \

Response Example

200: Success

{
  "status": "Success",
  "message": "Change PIN URL fetched successfully.",
  "code": 200,
  "data": [
    {
      "set_pin_url": "URL"
    }
  ]
}

400: Error

{
  "code": 400,
  "message": "Error Message",
  "status": "error"
}