Startbutton Product API
  • Startbutton API doc
    • Get Started
    • Accept Payments
    • Server-to-Server Integration
      • S2S Integration for Virtual Accounts
        • S2S Virtual account (NGN)
        • S2S Virtual account (GHS)
        • S2S EFT (ZAR)
      • S2S Integration for Mobile Money
        • S2S MoMo (KES and GHS)
        • S2S MoMo (TZS and UGX)
        • S2S MoMo (RWF)
        • S2S MoMo XOF and XAF
    • Re-charge Card
    • Subscriptions
    • Payment Links
    • Currency Conversion
    • Get Wallet Balance
    • Transfer
      • Bank List
    • Security Measures.
      • IP Whitelisting
    • Webhook
    • Transaction Status
    • Get FX Rate
    • Under and Overpayments
    • Refunds
      • Refund Transaction Status (TSQ)
    • Available Currencies
    • FAQs
  • Advanced Security
    • Signed Payload for Transfer Requests.
Powered by GitBook
On this page
  1. Startbutton API doc
  2. Server-to-Server Integration
  3. S2S Integration for Virtual Accounts

S2S Virtual account (GHS)

This payment method enables your customers pay-in by making transfers to the provided GHS VA provided, while ensuring you receive instant settlements.

Authorization
Set to Bearer PUBLIC_KEY

Content-type

Set value to application/json

The public key can be gotten from the 'Settings' page on your Startbutton

dashboard.

Post a request to the URL below, where the base URL is determined by the environment you are in.

BaseUrls

PROD : https://api.startbutton.tech

DEV/ Staging: https://api-dev.startbutton.tech

POST: {{baseurl}}/transaction/initialize-s2s

Here is a sample request below:

{
    "amount": 50000,
    "currency": "GHS",
    "email": "test-pms@customer.com",
    
}

The amount should be in fractional units.

Here is a sample response:

{
    "success": true,
    "message": "VA initiated",
    "data": {
        "accountNumber": "900xxxxxxxxxx",
        "expiryTime": "2024-09-06T11:57:32.082Z",
        "reference": "4fxxxxxxxxx",
        "bankName": "StartButton Bank",
        "accountName": "StartButton Merchant",
        "shortCode": "shc-jqzv2ktl2f"
    }
}
PreviousS2S Virtual account (NGN)NextS2S EFT (ZAR)

Last updated 2 months ago