VMC Transaction

POST /transactions

Description

Initiate a VMC (Virtual MasterCard) transaction.

Authentication

API Key (X-API-Key)

Request

Headers

Header	Value	Required
X-API-Key	{{apiKey}}	Yes
Content-Type	application/json	Yes

Request Body

{
  "amount": {{amount}},
  "paymentProcessorLabel": "{{paymentProcessor}}",
  "debitPhone": "+2630773591219",
  "debitRegion": "ZW",
  "debitCurrency": "{{debitCurrency}}",
  "debitRef": "velocityafrica",
  "creditPhone": "+263772364284",
  "creditRegion": "ZW",
  "creditAccount": "263772364284",
  "type": "REQUEST",
  "authType": "{{authType}}",
  "salesOrderId": "{{salesOrderId}}",
  "cancelUrl": "https://google.com",
  "successUrl": "https://velocityafrica.net"
}

Field	Type	Required	Description
amount	number	Yes	Transaction amount
paymentProcessorLabel	string	Yes	Payment processor identifier
debitPhone	string	Yes	Debit party phone number
debitRegion	string	Yes	Debit party region code
debitCurrency	string	Yes	Debit currency code
debitRef	string	Yes	Debit reference
creditPhone	string	Yes	Credit party phone number
creditRegion	string	Yes	Credit party region code
creditAccount	string	Yes	Credit party account
type	string	Yes	Transaction type (e.g., REQUEST)
authType	string	Yes	Authorization type
salesOrderId	string	Yes	Associated sales order ID
cancelUrl	string	No	Cancel redirect URL
successUrl	string	No	Success redirect URL