API Documentation

Integrate Tchotchom payment and transfer functionality into your applications with our RESTful API

Authentication

Secure your API requests with Basic Auth

Basic Authentication

All API requests require Basic Authentication using your API credentials:

Username:public_api_key

Password:secret_key

Authorization: Basic cHVibGljX2FwaV9rZXk6c2VjcmV0X2tleQ==

Note: Replace public_api_key and secret_key with your actual API credentials

Base URL

https://www.sbfastgroup.com/api/v1

Create Transfer

POST

Create a new transfer between accounts

/api/v1/moncash/transfers

Request Parameters

Field	Type	Required	Description
`amount`	number	Required	Transfer amount
`currency`	string	Required	Currency code (HTG, USD, etc.)
`recipient_email`	string	Required	Recipient's email address
`note`	string	Optional	Optional transfer note

Request Body

{
  "amount": 100,
  "currency": "HTG",
  "recipient_email": "recipient@example.com",
  "note": "Payment for services"
}

Response Example

{
  "success": true,
  "message": "Transfer created successfully",
  "data": {
    "id": 12345,
    "amount": 100,
    "currency": "HTG",
    "recipient_email": "recipient@example.com",
    "status": "pending",
    "note": "Payment for services",
    "created_at": "2025-11-19T10:30:00Z"
  }
}

cURL Example

curl -X POST https://www.sbfastgroup.com/api/v1/api/v1/moncash/transfers \
  -u public_api_key:secret_key \
  -H "Content-Type: application/json" \
  -d '{"amount":100,"currency":"HTG","recipient_email":"recipient@example.com","note":"Payment for services"}'

Approve Transfer

POST

Approve a pending transfer

/api/v1/moncash/transfer/{transfer_id}/approve

Request Parameters

Field	Type	Required	Description
`transfer_id`	number	Required	Transfer ID in URL path

Response Example

{
  "success": true,
  "message": "Transfer approved successfully",
  "data": {
    "id": 12345,
    "amount": 100,
    "currency": "HTG",
    "recipient_email": "recipient@example.com",
    "status": "approved",
    "approved_at": "2025-11-19T10:35:00Z"
  }
}

cURL Example

curl -X POST https://www.sbfastgroup.com/api/v1/api/v1/moncash/transfer/12345/approve \
  -u public_api_key:secret_key \
  -H "Content-Type: application/json"

Create Payment Sale

POST

Create a new payment transaction

/api/v1/payments

Request Parameters

Field	Type	Required	Description
`amount`	number	Required	Payment amount
`currency`	string	Required	Currency code (HTG, USD, etc.)
`payee_email`	string	Required	Merchant/payee email address
`description`	string	Optional	Payment description
`reference`	string	Optional	Order/invoice reference
`payment_method`	string	Required	Payment method (moncash, card, etc.)

Request Body

{
  "amount": 250,
  "currency": "HTG",
  "payee_email": "merchant@example.com",
  "description": "Product purchase",
  "reference": "ORD-2025-001",
  "payment_method": "moncash"
}

Response Example

{
  "success": true,
  "message": "Payment created successfully",
  "data": {
    "id": 67890,
    "amount": 250,
    "currency": "HTG",
    "payee_email": "merchant@example.com",
    "description": "Product purchase",
    "reference": "ORD-2025-001",
    "payment_method": "moncash",
    "status": "completed",
    "created_at": "2025-11-19T10:40:00Z"
  }
}

cURL Example

curl -X POST https://www.sbfastgroup.com/api/v1/api/v1/payments \
  -u public_api_key:secret_key \
  -H "Content-Type: application/json" \
  -d '{"amount":250,"currency":"HTG","payee_email":"merchant@example.com","description":"Product purchase","reference":"ORD-2025-001","payment_method":"moncash"}'

Need Help?

Our developer support team is here to help you integrate Tchotchom into your application. Contact us for API credentials and technical assistance.