Build with Mobile Money.
Ship faster.

[xylep_payment_form amount="5000" theme="dark" title="Pay Now"]

// Static amount
echo do_shortcode( '[xylep_payment_form amount="5000"]' );

// Dynamic amount from post meta
$amount = get_post_meta( get_the_ID(), '_product_price', true );
echo do_shortcode( "[xylep_payment_form amount="{$amount}" theme="dark"]" );

document.getElementById('xylep-amount').value = '25000';

$order  = wc_get_order( $order_id );
$amount = (int) $order->get_total();
echo do_shortcode( "[xylep_payment_form amount="{$amount}"]" );

async function pollPaymentStatus(ref, orderId) {
  const iv = setInterval(async () => {
    const data = await (await fetch(`/wp-json/xylep/v1/status/${ref}`)).json();
    if (data.status === 'successful') {
      clearInterval(iv);
      await fetch('/wp-json/xylep/v1/order-paid', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ order_id: orderId, xyle_ref: ref })
      });
      window.location.href = `/checkout/order-received/${orderId}/`;
    }
  }, 3000);
}

if ( isset( $_POST['withdraw_amount'] ) ) {
    $amount  = absint( $_POST['withdraw_amount'] );
    $balance = (int) get_user_meta( get_current_user_id(), 'wallet_balance', true );

    if ( $amount > 500 && $amount <= $balance ) {
        echo do_shortcode( "[xylep_payment_form amount="{$amount}" title="Confirm Withdrawal"]" );
    } else {
        echo '<p class="error">Invalid amount or insufficient balance.</p>';
    }
}

global $wpdb;
$table = $wpdb->prefix . 'xylep_transactions';

$tx = $wpdb->get_row( $wpdb->prepare(
    "SELECT * FROM {$table} WHERE transaction_ref = %s", $ref
) );

if ( $tx->status === 'successful' ) {
    // Fulfil the order
}

// Columns: id · transaction_ref · provider · phone · amount
//          currency · status (pending|successful|failed)
//          provider_ref · note · created_at · updated_at

Authorization: Bearer xk_sec_your_secret_key_here
Content-Type: application/json

curl -X POST https://api.xyle-payments.com/api/v1/client/deposit \
  -H "Authorization: Bearer xk_sec_your_key" \
  -H "Content-Type: application/json" \
  -d '{"account":"256771234567","amount":25000,"provider":"MTN_UGANDA"}'

const res = await fetch('https://api.xyle-payments.com/api/v1/client/deposit', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer xk_sec_your_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ account: '256771234567', amount: 25000, provider: 'MTN_UGANDA' }),
});

{
  "account":     "256771234567",   // Required — international format, no +
  "amount":      25000,             // Required — smallest currency unit (UGX)
  "provider":    "MTN_UGANDA",    // Required — "MTN_UGANDA" or "AIRTEL_UGANDA"
}

{
  "success":        true,
  "message":         "Deposit processed successfully",
  "data":            {
    "id":             "transaction-uuid-456",
    "type":           "DEPOSIT",
    "amount":         50000,
    "provider":       "MTN_UGANDA",
    "reference":      "XYLE-DEP-20260219-001",
    "status":         "COMPLETED",
    "account":        "256700000000",
    "netAmount":      50000,
    "createdAt":      "2026-02-19T11:00:00Z",
    "completedAt":    "2026-02-19T11:00:30Z"
  }
}

{
  "account":     "256700000000",   // Required — international format, no +
  "amount":      25000,             // Required — smallest currency unit (UGX)
  "provider":    "AIRTEL_UGANDA",  // Required — "MTN_UGANDA" or "AIRTEL_UGANDA"
}

{
  "success":        true,
  "message":        "Withdrawal processed successfully",
  "data":           {
    "transactionId": "transaction-uuid-789",
    "reference":     "XYLE-WD-20260219-001",
    "amount":        25000,
    "platformFee":   500,
    "netAmount":     24500,
    "status":        "PENDING"
  }
}

{
  "success":   false,
  "message":   "Insufficient balance. Required: 25500, Available: 15000"
}

{
  "success":  true,
  "data":     {
    "transactions": [
      {
        "id":          "transaction-uuid-456",
        "type":        "DEPOSIT",
        "amount":      50000,
        "provider":    "MTN_UGANDA",
        "reference":   "XYLE-DEP-20260219-001",
        "status":      "COMPLETED",
        "platformFee": 0,
        "netAmount":   50000,
        "createdAt":   "2026-02-19T11:00:00Z"
      },
      {
        "id":          "transaction-uuid-789",
        "type":        "WITHDRAWAL",
        "amount":      25000,
        "provider":    "AIRTEL_UGANDA",
        "reference":   "XYLE-WD-20260219-001",
        "status":      "PENDING",
        "platformFee": 500,
        "netAmount":   24500,
        "createdAt":   "2026-02-19T10:45:00Z"
      }
    ],
    "pagination": {
      "page":   1,
      "limit":  10,
      "total":  25,
      "pages":  3
    }
  }
}

{
  "transaction_ref": "xp_2025_abc123def456",
  "status":          "successful",  // pending | successful | failed
  "provider_ref":    "MTN_REF_XYZ789",
  "phone":           "256771234567",
  "amount":          25000,
  "currency":        "UGX",
  "provider":        "mtn",
  "reference":       "order-1234",
  "created_at":      "2025-02-15T10:32:00Z"
}

{
  "success": false,
  "code":    "invalid_phone",
  "message": "The phone number is not a valid Ugandan mobile number."
}