# Waftpay Developer Docs

## Docs

- [Get Authentication Token](https://docs.waftpay.io/api-reference/auth/auth-token.md): Exchange your consumer credentials for a short-lived Bearer token.
- [Create Checkout Request](https://docs.waftpay.io/api-reference/checkout/checkout-request.md): Initiate a hosted checkout session and receive a checkout URL.
- [Initiate Collection](https://docs.waftpay.io/api-reference/collections/collection-initiate.md): Create a customer collection request.
- [Refund/Reversal Status](https://docs.waftpay.io/api-reference/collections/collections-refund.md): Query the latest status of a refund or reversal request.
- [Initiate Refund/Reversal](https://docs.waftpay.io/api-reference/collections/collections-refund-initiate.md): Create a refund or reversal request for a collection payment.
- [Check Collection Status](https://docs.waftpay.io/api-reference/collections/collections-status.md): Retrieve the latest status of a collection using your reference or UUID.
- [API Reference](https://docs.waftpay.io/api-reference/index.md): Overview of Waftpay API reference endpoints.
- [Get Started](https://docs.waftpay.io/api-reference/payment-requests/get-started.md): Introduction to Payment Requests APIs – Payouts, Remittance, and Collections.
- [Rules & Process Flow](https://docs.waftpay.io/api-reference/payment-requests/rules-and-process-flow.md): Operational rules, gateway filtering, and controller/service responsibilities for Collections.
- [Initiate Payout](https://docs.waftpay.io/api-reference/payouts/payouts-initiate.md): Send money to a customer using Waftpay Payouts API.
- [Check Payout Status](https://docs.waftpay.io/api-reference/payouts/retrieve.md): Retrieve the latest status of a payout using a reference or UUID.
- [Initiate Remittance](https://docs.waftpay.io/api-reference/remittance/remittance-initiate.md): Create a remittance request.
- [Check Remittance Status](https://docs.waftpay.io/api-reference/remittance/remittance-status.md): Retrieve the latest status of a remittance using your reference or UUID.
- [Generate X-Custom-Signature](https://docs.waftpay.io/api-reference/signatures/signature-generate.md): Authoritative guide for creating and attaching the Base64 RSA signature required for Payouts and Remittance.
- [Get Balance](https://docs.waftpay.io/api-reference/wallet/get-balance.md): Fetch wallet balances for the authenticated product (collections, payouts, etc.). Filter by currency or fetch all.
- [Environments](https://docs.waftpay.io/environments.md): Sandbox vs Production, base URLs, and how to switch safely.
- [Errors](https://docs.waftpay.io/errors.md): How to read, troubleshoot, and act on Waftpay API errors.
- [Waftpay Developer Docs](https://docs.waftpay.io/index.md): Everything you need to integrate Waftpay payments, collections, and remittance into your apps.
- [Checkout](https://docs.waftpay.io/pages/guides/checkout.md): Create hosted checkout sessions, redirect customers, and handle callbacks.
- [Collections](https://docs.waftpay.io/pages/guides/collections.md): Receive customer payments with signing, acceptance, webhooks, and reconciliation guidance.
- [Payouts](https://docs.waftpay.io/pages/guides/payouts.md): End-to-end guide to sending payouts: auth, signing, request shape, callbacks, and reconciliation.
- [Refunds](https://docs.waftpay.io/pages/guides/refunds.md): Initiate a refund or reversal request and check its status.
- [Remittances](https://docs.waftpay.io/pages/guides/remittances.md): Cross-border payouts with KYC fields, signing, acceptance, and delivery confirmation.
- [Status Checks](https://docs.waftpay.io/pages/guides/status-checks.md): Poll the latest status when webhooks are delayed or unavailable.
- [Going Live](https://docs.waftpay.io/pages/intro/going-live.md): Checklist and requirements before you move to production with Waftpay.
- [How to Start](https://docs.waftpay.io/pages/intro/how-to-start.md): Step-by-step guide to begin integrating Waftpay.
- [What is Mobile Money?](https://docs.waftpay.io/pages/intro/what-is-mobile-money.md): A primer on how mobile money works and why it matters in digital payments.
- [What You Should Know](https://docs.waftpay.io/pages/intro/what-you-should-know.md): Key concepts and requirements before integrating Waftpay.
- [Best Practices](https://docs.waftpay.io/pages/webhooks/best-practices.md): Hardening guidance for production-grade webhook receivers.
- [Build Your Webhook Endpoint](https://docs.waftpay.io/pages/webhooks/building-your-endpoint.md): Minimal, fast, and secure callback handler patterns.
- [Webhook Consumer Service](https://docs.waftpay.io/pages/webhooks/consumer-service.md): How Waftpay consumes, validates, transforms, and delivers webhook notifications end-to-end.
- [Event Types](https://docs.waftpay.io/pages/webhooks/event-types.md): Quick reference for webhook statuses and example payloads.
- [Overview](https://docs.waftpay.io/pages/webhooks/overview.md): How Waftpay notifies your system about payment status changes via webhooks.
- [Payload](https://docs.waftpay.io/pages/webhooks/payload.md): JSON schema and examples for webhook notifications.
- [Retries & Idempotency](https://docs.waftpay.io/pages/webhooks/retries-and-idempotency.md): Delivery guarantees, retry policy, and how to make your endpoint idempotent.
- [Test & Simulate](https://docs.waftpay.io/pages/webhooks/testing-simulator.md): Send sample webhooks to your endpoint in sandbox.
- [Troubleshooting](https://docs.waftpay.io/pages/webhooks/troubleshooting.md): Common integration pitfalls and how to fix them.
- [Verify Signature (validation_hash)](https://docs.waftpay.io/pages/webhooks/verify-signature.md): How to verify webhook integrity.

## OpenAPI Specs

- [waftpay](https://docs.waftpay.io/openapi/waftpay.json)
- [openapi](https://docs.waftpay.io/api-reference/openapi.json)

## Optional

- [Run in Postman](https://waftpay.io/openapi/waftpay.postman.json)