Freedom Pay
  1. Card API
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 by order_id
      • Status by Payment ID
      • Status
    • Mobile balance
      • Overview
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Invoice
      • Overview
      • Init
      • Info
      • Pay
      • Status
    • SDK
      • JS SDK
      • Google Pay
      • Freedom QR
        • Reader SDK (Android)
        • Provider SDK (Android)
      • Payment SDK
        • iOS
        • Android
      • Merchant SDK
        • 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
      POST
    • Result notify
      POST
    • Payout notify
      POST
    • Check request
      POST
  • Card API
    • Overview
    • Client
      • Create client
      • Edit client
      • Update client
      • Verify client
      • Client info
    • Transactions
      • Create transaction
      • Clearing transaction
      • Refund transaction
      • Transaction info
      • Transaction status
    • Activate card
      POST
    • Block card
      POST
    • Balance
      POST
    • Bulk issue
      POST
    • Card info
      POST
    • Сards' list
      POST
    • Card tokenization
      POST
    • Cardholder validation
      POST
    • Close card
      POST
    • Issue card
      POST
    • Issue plastic card
      POST
    • Limits list
      POST
    • Operations' list
      POST
    • Reset PIN counter
      POST
    • Request' status
      POST
    • Secret data
      POST
    • Set limits
      POST
    • Set PIN
      POST
    • Statement extended
      POST
    • Unblock card
      POST
  • Partner API
    • Rates
      • Overview
      • Rates
    • Products
      • Overview
      • Dictionaries
      • Add client with product
      • Request status
      • Create terminal
    • 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
      • Settlement
        • Overview
        • Create payment
        • Payment status
        • Batch statuses
    • Invoice
  1. Card API

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
Set limits
Next
Statement extended