Skip to main content
POST
Create virtual account
Create a temporary virtual account that your customer can transfer funds into. When payment is received, Pasteaza sends a webhook notification and you can verify the transaction status with the verify virtual account status endpoint.
Create virtual accounts from your backend only. Use your secret key and store the returned reference so you can verify payment status later.

Endpoint

Headers

Request body

Example request

Successful response

Integration flow

1

Create the virtual account

Send the create request from your backend with the amount and customer details.
2

Show the account details

Display the returned accountNumber, accountName, bankName, bankCode, and amount to your customer.
3

Wait for payment

Ask the customer to transfer the exact amount before the account expires.
4

Confirm the status

Verify the payment status through the API or process the webhook notification from Pasteaza.

Notes

  • Every virtual account is unique to a collection request.
  • merchantReference is required.
  • expiresAt is optional and cannot be more than 24 hours from creation.
  • The customer should transfer the exact amount generated.
  • Payments are confirmed automatically through webhooks.
  • Store the returned reference so you can verify the payment later.

Next step

Verify virtual account status

Check whether a customer has completed the transfer.

Webhooks

Receive real-time payment notifications from Pasteaza.

Authorizations

Authorization
string
header
required

Use an sk_test_... key in the playground. Never enter a live key in shared environments.

Body

application/json
merchantReference
string
required
Example:

"COL-10001"

amount
integer
required

Amount in kobo.

Required range: x >= 100
Example:

500000

expiresAt
string<date-time>
metadata
object
Example:

Response

Virtual account created.

status
boolean
required
message
string
required
data
object
required