1. Card
Freedom Pay
  • Overview
  • Gateway API
    • Overview
    • Sync API
      • Overview
      • Purchase
        • Overview
        • Create payment
        • Any amount
        • Card
        • 3DSecure
        • Recurrent
        • Cancel
        • Clearing
        • Refund
        • Status
      • Payout
        • Overview
        • Card
        • IBAN
        • Balance
        • Status
      • Transfer
        • Overview
        • Card
        • 3DSecure
        • Rates
        • Status
      • Card
        • Overview
        • Add
        • 3DSecure
        • List
        • Remove
        • Status
      • Token
        • Overview
        • Token Pay
        • Apple Pay
        • Google Pay
        • Token Payout
        • Status
    • Async API
      • Overview
      • create
        • create payment
      • read
        • read payment
        • read request
      • edit
        • edit payment.refund
        • edit payment.reverse
        • edit payment.clearing
  • Merchant API
    • Overview
    • Purchase
      • Overview
      • Checkout
      • Card token
        • Overview
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment (with CVC)
        • Confirm payment (with CVC)
        • Create payment
        • Confirm payment
      • Create payment
      • Any amount
      • Reccuring payment
      • Cancel payment
      • Clearing
      • Refund payment
      • Status
    • Payout
      • Overview
      • Card token
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment
      • Create payment
      • IBAN
      • Balance status
      • Status
    • Mobile balance
      • Overview
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Invoice
      • Overview
      • Create invoice
      • Info
      • Refund
      • Status
      • Cancel
    • SDK
      • JS SDK
      • Merchant SDK
        • Google Pay
        • Android
        • IOS
    • CMS
      • Overview
      • Get Merchant ID and key
      • WordPress
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
        • Update
      • Tilda
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • InSales
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • Ecwid
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • Bitrix
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • PrestaShop
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
      • OpenCart
        • Overview
        • Installation
        • Configuration
        • Test
        • Live payments
    • Redirect back
    • Result notify
    • Payout notify
    • Check request
  • Card API
    • Overview
    • Client
      • Card link
      • Сards' list
      • Create client
      • Client info
      • Update client
      • Verify client
    • Transactions
      • Create transaction
      • Clearing transaction
      • Refund transaction
      • Transaction info
      • Transaction status (depricated)
      • Transaction status
    • Card
      • Activate card
        POST
      • Block card
        POST
      • Balance
        POST
      • Card info
        POST
      • Card update
        POST
      • Card tokenization
        POST
      • Close card
        POST
      • Find card
        POST
      • Issue card
        POST
      • Issue plastic card
        POST
      • Operations' list
        POST
      • Reset PIN counter
        POST
      • Statement extended
        POST
      • Set PIN
        POST
      • Secret data
        POST
      • Unblock card
        POST
    • Limits
      • Limits list
      • Set limits
    • Bulk issue
      POST
    • Cardholder validation
      POST
    • Request' status
      POST
  • Partner API
    • Rates
      • Overview
      • Rates
    • Products
      • Overview
      • Dictionaries
      • Add client with product
      • Client request status
      • Create terminal
      • Update terminal limits
      • Product request status
    • E-Money
      • Overview
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Device ID
      • Android SDK
      • iOS SDK
    • Implement SuperApp
      • Overview
      • Pay
      • Refund
    • Account
      • Overview
      • Create payment
      • Payment status
      • Batch statuses
      • Statement
      • Statement status
      • Balance
      • Balance status
    • Invoices
      • Info
  1. Card

Set PIN

POST
https://api.freedompay.kz/v5/card-api/card/set_pin
The PIN setup method is designed to set or change the Personal Identification Number (PIN) on a payment card. This process is essential for ensuring security when performing card transactions, such as cash withdrawals from ATMs and payments at retail locations.
The PIN can be provided in the request in the pin parameter, encrypted using a public key generated.
If the pin parameter is not provided in the request, the PIN will be automatically generated
The pin parameters must be contain encrypted data encoded in Base64 format. Encryption is performed using the RSA algorithm with PKCS-1.5 padding and the partner’s RSA public key. To retrieve the original values, the data must first be Base64-decoded, then processed using the partner’s RSA private key with RSA-PKCS-1.5 padding.

Request

Body Params application/json

Example
{
    "request_id": "019ab688-bef2-72c4-6a29-d0e08be76d95",
    "card_id": "019ade95-16a2-7783-a373-8911ee0b96af",
    "pin": "NidfkKGrJ+i7M5UT+UhJtyx3EHq2kyvS9Gvw0MBGjYmiaBdPb/yXie8TaCnoLIslIkjoRHL7HhJoORxFN7Fm0W/ey4gCgAW8yeBgmnYDcjaZD3TYzTtj8CkH+zs2hF/v0SYZmsGiAiSZ+sRkqzsP6aiTmXnae568O5RWpNY+BrWxcLnOifE0x1IQWtT239kReGpxUjl9lr8mcJD6J2VrbOGpzSc7Mns+kR6NjoPHQr5cBgNx8Sg9AdPY1CokIJCDT95+hH+sRAVXTXwn0YcpB5hXZ4AD4YFwnuVVei+ilcJq9gSr7kB8FlarFTX7IMHuJVEuQqikHzfLym2qdfugDJYaHFsE+uBSnX//wpSjaOGx/hg/m/LAq6xP3uHg9BC17vxVfn3N2VpJ+ym7BAepgxqjqadeCwDqWZyxrv3zMvDeFGnoHJEaPmh2IxO72fRHiAVPkMblvSAKl3iF28a47j9l5D5ApdDAxVeLuWUY26fjPnPUxiiZzJHxz/tqZFYEcdeLM+rKzKhIqQwAAqXYA4tb0SeCfUTkp96DEp+wLU5mG818Vm7Rro4Hfg/xsPjEylQKYj8VcChR5Gvdt5Yfk8S1xmqdi+UEvm7RNFEJxiTQ1kVrB7t5Q92kpUNY0BiswVb4YcevYvEGmPKUjDuOorhFaQKxNF//8hAH6h4AtvY="
}

Responses

🟢200Success
application/json
Body

Example
{
    "status": "ok",
    "request_status": "success",
    "dt": "2025-01-01T00:01:01+00:30"
}
Previous
Statement extended
Next
Secret data