# null
Source: https://docs.stablepay.ai/Send_to_Stablepay_Credential



A stablecoin powered peer-to-peer payments network for Africa.

Send to Stablecoin — a stablecoin credential linked to your wallet, making it simple and secure to send or receive stablecoins. A seamless stablecoin transfer experience, offering users a familiar interface similar to modern remittance apps, but built entirely on-chain using USDC.


# Countries and Limits
Source: https://docs.stablepay.ai/api-reference/countries-and-limits

Supported countries, mobile network operators, transaction limits and country codes.

<img alt="Description" />


# Get Payment Status
Source: https://docs.stablepay.ai/api-reference/endpoint/acceptPayments

GET /tx/payment-status/{reference}
Fetches the status of a transaction from the reference.



# Create Transaction Request
Source: https://docs.stablepay.ai/api-reference/endpoint/createTxReq

POST /tx/createTransferRequest
Create Transfer Request.



# Get FX Rate
Source: https://docs.stablepay.ai/api-reference/endpoint/fxRate

GET /fx/convert
Convert between supported currencies using current exchange rates.



# Get Payment Status
Source: https://docs.stablepay.ai/api-reference/endpoint/getMomoStatus

GET /momo/{transactionId}
Fetch Mobile Money transaction by ID



# Create Payment
Source: https://docs.stablepay.ai/api-reference/endpoint/momoPayment

POST /momo/payout
Enable peer-to-peer transfers, pay merchants or off-ramp stablecoins across Africa.



# Resolve Stablepay ID
Source: https://docs.stablepay.ai/api-reference/endpoint/resolveStablepayId

POST /id/resolve
Resolves Stablepay ID with supported wallet issuers.



# Validate Bank Account
Source: https://docs.stablepay.ai/api-reference/endpoint/validateBankAccount

POST /account/resolve
Validate account number and resolve account name for Banks in Kenya and Nigeria.



# Validate MoMo Account
Source: https://docs.stablepay.ai/api-reference/endpoint/validateMomoStatus

POST /momo/resolve
Validate M-Pesa merchants (Till/Paybill) or resolve mobile money operators by phone number



# Introduction
Source: https://docs.stablepay.ai/api-reference/introduction

A stablecoin powered, peer-to-peer, payment network for Africa.

<Note>
  To call any of the Stablepay's endpoints listed here you have to request an API-KEY
</Note>

## Welcome

Click the card bellow to get started with the Stablepay APIs

<Card title="Stablepay Endpoints" icon="code" href="/api-reference/endpoint/get">
  View the OpenAPI specification file
</Card>

## Authentication

All API endpoints are authenticated using Bearer tokens and picked up from the specification file.

```json theme={null}
"security": [
  {
    "bearerAuth": ""
  }
]
```


# Payment Status: Validating MoMo Transfers
Source: https://docs.stablepay.ai/api-reference/payment-status



When a user completes a mobile money payment request (M-Pesa, MTN Momo, etc.), you can check the transaction status using the transaction ID from your payment request.

Use the `/momo/{transactionId}` endpoint to get the current status of your mobile money transaction.

## Get MoMo Payment Status

**GET** `/momo/{transactionId}`

### Headers

* **Authorization**: `Bearer {STA_xxxx}` (required)

### Path Parameters

* **transactionId** (string, required): Transaction ID from your payment request (5-15 characters)

### Response

* **status**: `Successful` or `Unsuccessful`
* **confirmationID** (string): M-Pesa payment confirmation code (if successful)

### Common Issues

If the endpoint returns an error, it could be because:

* Transaction is still processing
* Customer hasn't completed the payment
* Invalid transaction ID provided

<Note>
  To call any of Stablepay's endpoints you need to request an API-KEY
</Note>


# null
Source: https://docs.stablepay.ai/changelog



# Stablepay Change Log

This document provides a chronological list of notable changes, updates, and improvements made to the Stablepay platform. We recommend all developers to regularly review this change log to stay informed about new features, optimizations, deprecations, and potential breaking changes.

## \[Added]

* Updated endpoint: `/tx/createTransferRequest` to take new acquirer field
* Deprecated devnet field, real and test transaction have the same metadata, no need for discriminator
* Atomic disbursement transactions

## \[Unreleased]

* New endpoint: `/v2/transactions/generateReference` to generate reference for transactions
* Support for custom transaction metadata
* Webhook notifications for failed transactions

### Added

* Better Error handly for failed disbursement

### Changed

* Improved transaction processing speed

### Deprecated

* Legacy reporting API (to be removed in v2.5.0)

## \[v2.1.0] - 2024-08-15

### Changed

* Change API Keys
* Optimized database queries for faster response times

### Fixed

* Issue with decimal precision in high-value transactions
* Rare race condition in concurrent withdrawals

## \[v2.0.0] - 2024-05-20

### Added

* Complete API redesign for improved developer experience
* Real-time payment status retrieval

### Changed

* Authentication mechanism: Now using JWT
* Renamed several API endpoints for consistency (see migration guide)
* Improved error messages with more detailed information

### Deprecated

* v1 API (to be removed on 2024-05-01)

### Removed

* Support for legacy integrations

## \[v1.5.2] - 2024-03-23

### Fixed

* Security patch for potential XSS vulnerability.
* Corrected inconsistent behavior in split wallet generation

## \[v1.5.1] - 2024-03-22

### Fixed

* Rare issue with transaction rollback in high-concurrency scenarios

## \[v1.0.0] - 2024-03-14

### Added

* Initial release of Stable Pay API
* Basic payment processing functionality
* User authentication and authorization
* Transaction history and reporting
* Webhook notifications for payment events

## How to Use This Change Log

* **Version Numbers**: We use semantic versioning (MAJOR.MINOR.PATCH).
* **Categories**: Changes are grouped into Added, Changed, Deprecated, Removed, and Fixed.
* **Dates**: Release dates are in YYYY-MM-DD format.
* **\[Unreleased]**: This section contains upcoming changes that are not yet released.

## Staying Updated

To ensure you're always using the latest features and following best practices:

1. Regularly check this change log for updates.

For any questions about these changes or for migration assistance, please contact our developer support team at [hello@stablepay.com](mailto:hello@stablepay.com).


# Introduction
Source: https://docs.stablepay.ai/introduction

A stablecoin powered, peer-to-peer, payment network for Africa.

<img alt="Hero Light" title={true} />

<img alt="Hero Dark" />

## Key Features

**Spend with Stablecoin** — a seamless, secure way to pay directly from your crypto wallet.Powered by digital dollars, Stablepay enables users to shop at merchants, pay bills or transfer funds.

**Send to Stablecoin** — a stablecoin credential linked to your wallet, making it simple and secure to send or receive stablecoins. A seamless stablecoin transfer experience, offering users a familiar interface similar to modern remittance apps, but built entirely on-chain using USDC.

<CardGroup>
  <Card title="Contact Us" icon="envelope" href="https://stablepay.ai">
    Get your API-KEY to receive payments using Stablepay.
  </Card>

  <Card title="API Documentation" icon="code" href="/api-reference/introduction">
    Test out our endpoints before using in your dev enviroment
  </Card>
</CardGroup>

## Support

If you have questions during the setup process, please reach out to:

[**hello@stablepay.ai**](mailto:hello@stablepay.ai)


# Quickstart
Source: https://docs.stablepay.ai/quickstart

Start collecting payments with Stablepay!

## Introduction

Welcome to Stablepay! This quickstart guide will help you integrate mobile money services like M-Pesa and other mobile money providers into your application using our provisioned endpoints.

## Prerequisites

Before you begin, ensure you have:

* Basic knowledge of blockchain technology
* Familiarity with RESTful APIs
* A development environment set up for your preferred programming language

## Setup Requirements

* **API Access**: Request API access from Stablepay.

## Next Steps

Once you've completed the setup process:

1. **Explore the API Documentation**: Visit our comprehensive API docs to understand the available endpoints and how to interact with them.
2. **Test out endpoints**: We offer API enviroments in various programming languages to simplify your integration process. Find them in the "Downloads" section of the API Portal.

## Best Practices

* Keep your API credentials and wallet private keys secure.
* Implement proper error handling in your integration.
* Stay updated with our changelog for any API updates or new features.
* Implement webhooks for real-time notifications about transaction statuses.

## Support

If you encounter any issues or have questions during the setup process, please don't hesitate to reach out:

* Email: [hello@stablepay.ai](mailto:hello@stablepay.ai)

##