Developer Tools

The Developer section of your Yativo dashboard provides all the tools you need to manage API access, audit usage, and secure your integration.

API Keys

Your API credentials consist of:

Account ID — found in Dashboard → Settings → Account
App Secret — generated in Dashboard → Developer → API Key

Generate App Secret

A 4-digit transaction PIN is required before generating a new App Secret.

GET /generate-secret

# First verify your PIN
curl -X POST 'https://api.yativo.com/api/v1/pin/verify' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "pin": "1234" }'

# Then generate a new secret
curl -X GET 'https://api.yativo.com/api/v1/generate-secret' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "status": "success",
  "data": {
    "app_secret": "yat_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ123456789"
  }
}

Generating a new secret invalidates your previous App Secret immediately. Update all systems that use the old secret before regenerating.

Transaction PIN

The 4-digit transaction PIN is required for sensitive operations: generating a new App Secret, initiating large transfers, and certain administrative actions.

Set or Update PIN

POST /pin/update

string

required

Your new 4-digit numeric PIN.

curl -X POST 'https://api.yativo.com/api/v1/pin/update' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "pin": "5678" }'

Verify PIN

POST /pin/verify

string

required

Your current 4-digit PIN.

curl -X POST 'https://api.yativo.com/api/v1/pin/verify' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "pin": "5678" }'

Two-Factor Authentication (2FA)

Enable 2FA on your dashboard account for additional security (Dashboard → Developer → Security → 2FA).

Step 1: Generate a 2FA Secret

POST /generate-2fa-secret

Returns a secret to enter into your authenticator app (Google Authenticator, Authy, etc.):

curl -X POST 'https://api.yativo.com/api/v1/generate-2fa-secret' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Idempotency-Key: unique-key-here'

Step 2: Enable 2FA

POST /enable-2fa

After scanning the QR code in your authenticator app:

curl -X POST 'https://api.yativo.com/api/v1/enable-2fa' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Idempotency-Key: unique-key-here'

Step 3: Verify a 2FA Code

POST /verify-2fa

otp

string

required

The 6-digit OTP from your authenticator app.

curl -X POST 'https://api.yativo.com/api/v1/verify-2fa' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "otp": "123456" }'

Webhooks

Configure and manage webhook endpoints for real-time event notifications. See the Webhooks guide for full details.

GET /business/webhook — get current webhook configuration
POST /business/webhook — set webhook URL
PUT /business/webhook/{webhook_id} — update webhook URL

API Request Logs

Audit every API call made against your account:

GET /business/logs/all

status

string

Filter by HTTP status code (e.g. 200, 400, 500).

method

string

Filter by HTTP method: GET, POST, PUT, DELETE.

page

number

Page number.

per_page

number

Results per page.

curl -X GET 'https://api.yativo.com/api/v1/business/logs/all?method=POST&status=400&per_page=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Events

View all events sent to your webhook endpoint and inspect individual event payloads.

List All Events

GET /business/events/all

per_page

number

Results per page.

curl -X GET 'https://api.yativo.com/api/v1/business/events/all?per_page=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Get Single Event

GET /business/events/show/{id}

string

required

The event ID.

curl -X GET 'https://api.yativo.com/api/v1/business/events/show/evt_01HX9KZMB3F7VNQP8R2WDGT4E5' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Get Started

Payments

Wallets

Customers & Compliance

Transactions

Products

Developer Tools

Regional Guides

Developer Tools

API Keys

Generate App Secret

Transaction PIN

Set or Update PIN

Verify PIN

Two-Factor Authentication (2FA)

Step 1: Generate a 2FA Secret

Step 2: Enable 2FA

Step 3: Verify a 2FA Code

Webhooks

API Request Logs

Events

List All Events

Get Single Event

​API Keys

​Generate App Secret

​Transaction PIN

​Set or Update PIN

​Verify PIN

​Two-Factor Authentication (2FA)

​Step 1: Generate a 2FA Secret

​Step 2: Enable 2FA

​Step 3: Verify a 2FA Code

​Webhooks

​API Request Logs

​Events

​List All Events

​Get Single Event

API Keys

Generate App Secret

Transaction PIN

Set or Update PIN

Verify PIN

Two-Factor Authentication (2FA)

Step 1: Generate a 2FA Secret

Step 2: Enable 2FA

Step 3: Verify a 2FA Code

Webhooks

API Request Logs

Events

List All Events

Get Single Event