Fikäfi APIs
  1. Authentication API
Fikäfi APIs
  • Fikäfi APIs
    • Getting Started
    • Authentication
    • API Error Handling
    • APIs / Endpoints
      • Authentication API
        • token API
          POST
      • Payments APIs
        • createPayment API
          POST
        • takePaymentAction API
          POST
        • createOnlinePayment API
          POST
      • Status API
        • getPaymentStatus API
          GET
        • getPayments API
          GET
      • Your Webhooks
        • paymentEvent webhook
          POST
        • paymentDetails Webhook
          POST
    • Tutorials
      • Request Payments
      • Check Status
      • Payment Failures
  1. Authentication API

token API

POST
https://demo.encorepay.co/FikafiSandbox/FikafiApi/api/auth/token

🔐 Authentication#

Fikäfi APIs are secured using Bearer Token authentication. Before calling any API, clients must obtain a token using their unique clientId and secretKey.

🔑 How It Works#

1.
You authenticate using your provided clientId and secretKey.
2.
In return, Fikäfi provides a short-lived Bearer token.
3.
Use that token in the Authorization header for all API requests.

📥 Token Request#

To get a Bearer token, make a POST request to the authentication endpoint.

🧾 Token Endpoint#

POST /auth/token
Content-Type: application/json

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🟠401Unauthorized
🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://demo.encorepay.co/FikafiSandbox/FikafiApi/api/auth/token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientId": "fikafi@mlvp.io",
    "key": "$2b$10$fixedsaltsaltfixedsaleyCl0AE/3MQaFBtqtC.STYfO8ldTygz2"
}'
Response Response Example
200 - Success Response
{
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "tokenType": "Bearer",
    "expiresIn": 84600
}
Modified at 2025-09-03 04:45:03
Previous
API Error Handling
Next
createPayment API
Built with