Skip to main content
Use this guide to create your first virtual account collection with Pasteaza. You will create a merchant account, get your API keys, make an authenticated request, and verify the payment status.
Start in test mode with your sk_test_ key. Switch to live mode only after you have tested collections, webhooks, and idempotency.

​
Before you begin

You need:
  • A Pasteaza merchant account
  • Your test secret key
  • A backend environment that can send HTTPS requests
  • A webhook endpoint if you want real-time transaction updates

​
Get started

1

Create a merchant account

Create your merchant account at Pasteaza.
After your account is ready, open the developer dashboard to access your API credentials.
2

Get your API keys

Pasteaza provides separate keys for test mode and live mode.Keep your secret key on your backend server. Never expose it in frontend code or mobile apps.
3

Make your first request

Create a virtual account collection request from your backend using your test secret key.
4

Receive bank transfer details

Pasteaza returns a virtual account that your customer can use to complete payment.
5

Verify the payment

Verify the collection from your backend or listen for a webhook notification when the payment status changes.

​
Example flow

Create a virtual account

Initialize a bank transfer collection for your customer.

Verify virtual account status

Confirm the final payment status before you fulfill an order.
  • Use the sandbox base URL while building.
  • Authenticate every request with your secret key.
  • Use an Idempotency-Key when creating bank transfers.
  • Verify webhooks before processing events.
  • Store transaction references in your database.

​
Next steps

Base URL

Review sandbox and production endpoints.

Authentication

Learn how to authenticate requests with API keys.

Idempotency

Prevent duplicate transactions when retrying requests.

Webhooks

Receive and verify real-time transaction notifications.