Initiate a wallet topup

POST 
/v1/partners/wallet/init-topup

This endpoint allows you to initiate a topup. The response will contain a redirect url to the payment gateway.

Request

application/json

Body

The request body to be sent with this request

amount numberrequired

The amount to be topped up

currency stringrequired

The currency of the amount. You should already have a wallet for this currency

Responses

200

OK

application/json

Schema

Schema

payment_link string

The payment link to be used to make the payment

Example (from schema)

{
  "payment_link": "https://checkout.paystack.com/hpq3a1iw9exaj66"
}

400

Bad Request. For all payment gateway errors

application/json

Schema

Schema

message string

Example (from schema)

{
  "message": "Currency not supported by merchant"
}

422

Unprocessable Content. For all input validation errors

application/json

Schema

Schema

message string
errors object
amount string[]
currency string[]

Example (from schema)

{
  "message": "The given data was invalid",
  "errors": {
    "amount": [
      "The amount field is required"
    ],
    "currency": [
      "You do not have a wallet for this currency"
    ]
  }
}

Loading...