Skip to main content

Creating Transactions

Required Fields​

Core Transaction Data​

  • amount - Transaction amount
  • currency - Currency code
  • reference - Your unique reference
  • statementDescriptor - Statement description
  • callbackUrl - Webhook URL

Mandatory Customer Information​

  • billing.firstName - Customer's first name
  • billing.lastName - Customer's last name
  • billing.email - Customer's email address
  • billing.customerReference - Your unique customer identifier

Endpoint​

POST /api/v1/transactions

Basic Request Example​

{
  "amount": 100.00,
  "currency": "USD",
  "reference": "ORDER-123",
  "statementDescriptor": "My Store Purchase",
  "callbackUrl": "https://your-domain.com/webhook",
  
  "billing": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@example.com",
    "customerReference": "CUST123"
  },
  
  "payment": {
    "paymentMethod": "CARD"
  }
}

Response​

{
  "transactionId": "TX123456789",
  "reference": "ORDER-123",
  "currency": "USD",
  "amount": 100.00,
  "status": "PENDING",
  "message": "Transaction created successfully",
  "checkoutUrl": "https://checkout.zepopay.com/TX123456789"
}