Set Pin

Use this API to set or update the PIN for a specific card. This is used when a cardholder sets their PIN for the first time or requests a PIN change.

Pass the cardIdForSetPin as a path parameter to identify the card, and set the command query parameter to REQUEST_CHANGE_PIN_URL. The response returns a secure URL that the cardholder can use to complete the PIN update process.

Note: The PIN is not set directly through this API. Instead, a secure URL is returned, ensuring the PIN is entered by the cardholder in a PCI-compliant environment.

A successful response confirms that the PIN change request has been initiated and returns the secure PIN entry URL.

Path Params
integer
required
Defaults to 123

The unique identifier for the card for which the pin need to be updated.
Example: 123

Query Params
string
enum
required

The specific command to be executed for setting the PIN on a card. This field determines the action to be performed based on the provided command value.

Allowed:
Headers
string
required

The ID of your banking instance visible in the MBANQ Console.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json