Skip to main content

​
Welcome to the Yabetoo API

The Yabetoo API is organized around REST principles, featuring predictable resource-oriented URLs, JSON request and response bodies, and standard HTTP response codes. Our API is designed to be simple, secure, and developer-friendly.

Base URL

All API requests should be made to: https://api.yabetoopay.com

​
Quick Start

Get started with the Yabetoo API in minutes:
1

Get Your API Keys

Sign up and obtain your API keys from the developer dashboard
2

Make Your First Request

Test the API by creating a checkout session or payment intent
3

Handle Webhooks

Set up webhooks to receive real-time notifications about payment events

​
Authentication

All API endpoints require authentication using your secret API key. Include your key in the Authorization header of every request: 
Authorization: Bearer your_secret_key_here
Never expose your secret API keys in client-side code. Always make API calls from your server.

​
Request Format

The Yabetoo API accepts JSON-formatted request bodies and returns JSON responses. Always include the appropriate Content-Type header: 
Content-Type: application/json

​
Example Request

curl -X POST "https://api.yabetoopay.com/v1/checkout-sessions" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2000,
    "currency": "EUR",
    "success_url": "https://yoursite.com/success",
    "cancel_url": "https://yoursite.com/cancel"
  }'

​
Core Resources

​
Checkout Sessions

Create secure, hosted payment pages for accepting payments without handling sensitive card data.

Checkout Sessions

Create and manage checkout sessions for hosted payments

​
Payment Intents

Build custom payment flows with full control over the payment process.

Payment Intents

Create and confirm payment intents for advanced integrations

​
Disbursements

Transfer funds from your account to customer accounts for marketplace and platform scenarios.

Disbursements

Send money to customers or partners

​
Remittances

Enable international money transfers with our remittance API.

Remittances

Process cross-border payments and transfers

​
Webhooks

Receive real-time notifications about events in your account.

Webhooks

Configure endpoints to receive event notifications

​
HTTP Status Codes

The Yabetoo API uses standard HTTP status codes to indicate success or failure:
CodeDescription
200Success - Request completed successfully
201Created - Resource created successfully
400Bad Request - Invalid request parameters
401Unauthorized - Invalid or missing API key
402Payment Required - Insufficient funds or failed payment
403Forbidden - Access denied
404Not Found - Resource not found
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Something went wrong on our end

​
Error Handling

When an error occurs, the API returns a JSON object with error details: 
{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_missing",
    "message": "Missing required parameter: amount",
    "param": "amount"
  }
}

​
Error Types

  • api_error - Issues with our API
  • authentication_error - Problems with your API key
  • invalid_request_error - Invalid parameters or format
  • rate_limit_error - Too many requests
  • payment_error - Payment processing failed

​
Rate Limiting

The Yabetoo API implements rate limiting to ensure fair usage:
  • Test Mode: 100 requests per minute
  • Live Mode: 1000 requests per minute
Rate limit information is included in response headers: 
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

​
Pagination

List endpoints support pagination using limit and offset parameters: 
GET /v1/payment-intents?limit=20&offset=40
Response includes pagination metadata: 
{
  "data": [...],
  "has_more": true,
  "total": 150
}

​
Idempotency

Safely retry requests by including an Idempotency-Key header with a unique value: 
Idempotency-Key: your-unique-key-here
This prevents duplicate processing if you need to retry a request.

​
Versioning

The current API version is v1. We maintain backward compatibility and announce changes well in advance. Specify the API version in your requests: 
GET https://api.yabetoopay.com/v1/payment-intents

​
SDKs and Libraries

Accelerate your integration with our official SDKs:

PHP SDK

Official PHP library for server-side integration

Java SDK

Enterprise-ready Java SDK

​
Testing

Use our sandbox environment to test your integration without processing real payments:
  • Test API Key: Starts with sk_test_
  • Test Endpoint: Same as live (https://api.yabetoopay.com)
  • Test Cards: Use our test card numbers

​
Support

Need help with the API?
  • Documentation: Complete guides and examples
  • Developer Support: Contact our technical team
  • Status Page: Check API status and uptime
  • Community: Join our developer community
This API reference provides complete documentation for all Yabetoo API endpoints. Each endpoint includes request/response examples, parameter descriptions, and error codes.
⌘I