Documentation — Txenka

Introduction

The Txenka API is built around payment_intents — every payment you create and confirm. All requests and responses use JSON, and the base URL is https://api.txenka.com/v1.

Authentication

Every authenticated call uses your API key in the Authorization header. Find your key under Settings → API Keys in the dashboard — use txk_test_… to test without processing real money, and txk_live_… in production.

HTTP Header

Authorization: Bearer txk_test_8f2a3c9d1e...

Create a payment

A payment_intent represents a charge. Amounts are always in cents (2450 = 24.50 MZN).

curl -X POST https://api.txenka.com/v1/payment-intents \
  -H "Authorization: Bearer txk_test_8f2a3c9d1e..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2450,
    "currency": "MZN",
    "payment_method": "mpesa",
    "customer_phone": "258840000000",
    "description": "Pedido #1042"
  }'

const res = await fetch('https://api.txenka.com/v1/payment-intents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer txk_test_8f2a3c9d1e...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amount: 2450,
    currency: 'MZN',
    payment_method: 'mpesa',
    customer_phone: '258840000000',
    description: 'Pedido #1042',
  }),
});
const intent = await res.json();

$ch = curl_init('https://api.txenka.com/v1/payment-intents');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer txk_test_8f2a3c9d1e...',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'amount' => 2450,
        'currency' => 'MZN',
        'payment_method' => 'mpesa',
        'customer_phone' => '258840000000',
        'description' => 'Pedido #1042',
    ]),
]);
$intent = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://api.txenka.com/v1/payment-intents",
    headers={"Authorization": "Bearer txk_test_8f2a3c9d1e..."},
    json={
        "amount": 2450,
        "currency": "MZN",
        "payment_method": "mpesa",
        "customer_phone": "258840000000",
        "description": "Pedido #1042",
    },
)
intent = response.json()

require 'net/http'
require 'json'

uri = URI('https://api.txenka.com/v1/payment-intents')
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer txk_test_8f2a3c9d1e...'
req['Content-Type'] = 'application/json'
req.body = {
  amount: 2450,
  currency: 'MZN',
  payment_method: 'mpesa',
  customer_phone: '258840000000',
  description: 'Pedido #1042',
}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
intent = JSON.parse(res.body)

body, _ := json.Marshal(map[string]any{
    "amount":         2450,
    "currency":       "MZN",
    "payment_method": "mpesa",
    "customer_phone": "258840000000",
    "description":    "Pedido #1042",
})

req, _ := http.NewRequest("POST", "https://api.txenka.com/v1/payment-intents", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer txk_test_8f2a3c9d1e...")
req.Header.Set("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()

var body = """
    {"amount":2450,"currency":"MZN","payment_method":"mpesa",
     "customer_phone":"258840000000","description":"Pedido #1042"}""";

var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.txenka.com/v1/payment-intents"))
    .header("Authorization", "Bearer txk_test_8f2a3c9d1e...")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

var response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "object": "payment_intent",
  "id": "pi_01hx4k9…",
  "status": "requires_confirmation",
  "amount": 2450,
  "currency": "MZN",
  "payment_method": "mpesa"
}

Confirm the payment

Confirming triggers the request with the chosen method — for example, an STK push request on the customer's phone for M-Pesa/e-Mola.

curl -X POST https://api.txenka.com/v1/payment-intents/pi_01hx4k9…/confirm \
  -H "Authorization: Bearer txk_test_8f2a3c9d1e..."

const res = await fetch(
  'https://api.txenka.com/v1/payment-intents/pi_01hx4k9…/confirm',
  { method: 'POST', headers: { 'Authorization': 'Bearer txk_test_8f2a3c9d1e...' } }
);
const result = await res.json();

$ch = curl_init('https://api.txenka.com/v1/payment-intents/pi_01hx4k9…/confirm');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer txk_test_8f2a3c9d1e...'],
]);
$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://api.txenka.com/v1/payment-intents/pi_01hx4k9…/confirm",
    headers={"Authorization": "Bearer txk_test_8f2a3c9d1e..."},
)
result = response.json()

require 'net/http'
require 'json'

uri = URI('https://api.txenka.com/v1/payment-intents/pi_01hx4k9…/confirm')
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer txk_test_8f2a3c9d1e...'

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
result = JSON.parse(res.body)

req, _ := http.NewRequest(
    "POST",
    "https://api.txenka.com/v1/payment-intents/pi_01hx4k9…/confirm",
    nil,
)
req.Header.Set("Authorization", "Bearer txk_test_8f2a3c9d1e...")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()

var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.txenka.com/v1/payment-intents/pi_01hx4k9…/confirm"))
    .header("Authorization", "Bearer txk_test_8f2a3c9d1e...")
    .POST(HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

The returned status can be processing (awaiting customer confirmation), succeeded or failed. For asynchronous methods, subscribe to a webhook to know when the state changes without polling the API.

Payment methods

mpesa M-Pesa — Vodacom mobile wallet

emola e-Mola — Movitel mobile wallet

card Card — Visa and Mastercard

bank_transfer Bank transfer

Webhooks

Configure an endpoint under Settings → Webhooks in the dashboard to receive an HTTP POST notification whenever a payment's status changes — without polling the API.

Main events

payment_intent.succeeded

The payment was confirmed successfully.

payment_intent.failed

The payment failed or was declined.

payment_intent.processing

Awaiting customer confirmation (e.g. STK push sent).

Errors

Errors always follow the same shape, with a stable code you can handle programmatically and a human-readable message.

Response

{
  "error": {
    "code": "payment_method_disabled",
    "message": "O método de pagamento 'mpesa' não está activo para esta conta."
  }
}

Need help integrating?

Our team answers technical questions about the API.

Talk to the team