Payscribe developer platform

Build money movement your customers can trust.

A practical API guide for collecting payments, sending payouts, issuing cards, and managing money across your business.

How the platform fits together

Collect, manage, and move money in one flow.

Start with an incoming payment, keep an accurate business balance, then use that balance for payouts, cards, bills, or currency conversion.

Collect

Receive funds through virtual accounts, payment links, invoices, or supported deposit methods.

Manage

Check balances, reconcile transactions, manage customers, and listen for webhook events.

Move

Send payouts, fund cards, pay bills, or convert supported currencies as your product requires.

Understand the full funds flow

A developer-first API

Make a useful request before writing your integration.

Use sandbox credentials to inspect real response shapes, then follow a product guide to build the complete workflow around them.

Make your first sandbox request

Sandbox request

# Fetch available wallet balances
curl https://sandbox.payscribe.ng/api/v1/my-account/balances \
  -H "Authorization: Bearer ps_pk_test_..."

# 200 OK
{
  "status": true,
  "data": [
    { "currency": "NGN", "available_balance": 2450000 }
  ]
}

Choose a journey

Start with what you want to build.

Each guide connects the product concept, API calls, webhooks, and production considerations in one place.

Collections

Receive money

Create virtual accounts, payment links, and invoices that reconcile to your business wallet.

Build a collection flow Payouts

Send money

Validate recipients, make single or bulk transfers, and track every payout to completion.

Build a payout flow Card issuing

Issue and manage cards

Create cards, fund them, set up lifecycle actions, and react to card events.

Start issuing cards More products

Build your money movement stack

Add bills, multi-currency FX, stablecoins, savings, and invoice workflows as your product grows.

Explore all guides

Build real financial products

Start from a solution, not an endpoint list.

Use these patterns to understand how Payscribe services work together in the products your customers actually use.

Collections · Transfers · Webhooks

Marketplace payouts

Collect customer payments, validate seller accounts, then pay vendors individually or in bulk.

Explore the building blocks Invoices · Virtual accounts · Webhooks

Invoice and collection workflow

Create a customer, send an invoice or account number, and reconcile payment events automatically.

Explore the building blocks Cards · Wallet funding · Events

Business spend controls

Issue cards for a team or customer product, fund them, and monitor every card transaction.

Explore the building blocks FX · Wallets · Transaction reports

Multi-currency operations

View rates, create a conversion quote, execute it, and maintain an auditable funds flow.

Explore the building blocks

Get productive quickly

From zero to a production-ready integration.

Set up safely

Get sandbox keys, understand authentication, and keep credentials out of your client application.

Set up authentication

Build one complete flow

Follow a recipe that shows the API call, webhook handling, and how to confirm the result.

Receive a payment

Ship with confidence

Test duplicate handling, failed requests, webhooks, and production configuration before launch.

Use the go-live checklist

Start from working patterns

Follow a complete recipe, not isolated endpoints.

These guides take you through the sequence developers need in a real integration: setup, API calls, sandbox testing, and webhook confirmation.

Collections recipe

Receive a payment via virtual account

Create a customer and virtual account, simulate an inbound payment in sandbox, then confirm it from a verified webhook.

Start the recipe Cards recipe

Issue your first card

Create a customer, issue and fund a card, then retrieve its balance and transaction activity.

Start the recipe

Developer resources