Create payment

POST api/v2/paygate/payment/wallet/
Create a payment by wallet

Request Body schema

application/json

Field	Type	Required	Description	Example
endpoint	string	Yes	Api key	"92b6aee5-54a0-496c-8972-aff1f78010c1"
amount	integer	Yes	Amount in minor units	1000
currency	integer	Yes	Number code	404
buyer	object	Yes	Buyer at the endpoint in JSON format	{"remote_id": "string", "ip": "string"}
client_id	string	No	Transaction id at the endpoint. Max 255 chars	"string"
success_url	string or null	No	Redirect URL after success result	"http://example.com"
fail_url	string or null	No	Redirect URL after fail result	"http://example.com"
notify_url	string or null	No	Notification URL of changed status	"http://example.com"
bank_code	string	Yes	The customer's bank code.	"000000"
first_name	string	Yes	The customer's fisrt name.	"John"
last_name	string	Yes	The customer's last name.	"Smith"
payment_method	string	Yes	The payment method. Must be: bank	"bank"
phone	string	Yes	The customer's phone.	"+254999999999"
country	string	Yes	The customer's code country. (ISO 3166-1 alpha-2)	"KE"

Request sample

{
    "endpoint": "92b6aee5-54a0-496c-8972-aff1f78010c1",
    "amount": 1000,
    "currency": 404,
    "buyer": {
        "remote_id": "string",
        "ip": "string"
    },
    "client_id": "string",
    "success_url": "http://example.com",
    "fail_url": "http://example.com",
    "notify_url": "http://example.com",
    "bank_code": "000000",
    "first_name": "John",
    "last_name": "Smith",
    "payment_method": "bank",
    "phone": "+254999999999",
    "country": "KE"
}

Response sample

STATUS 201

{
  "redirect_url": "https://example.com",
  "info": {
    "tx": "69cbbe70-d9bb-46e3-b67f-4d259712112e",
    "payment": {},
    "status": "create",
    "currency": {
      "id": 29,
      "title": "KES",
      "char_code": "KES",
      "num_code": 404,
      "depth": 2
    },
    "amount": 1000,
    "created_at": "2025-06-03T11:41:20.547225Z",
    "errors": [],
    "parts_tx": [],
    "additional_data": {},
    "endpoint_logo": null
  }
}