POST
/
payments
/
v1
/
payments
/
direct-charge
curl --request POST \
  --url https://sandbox-api.payfonte.com/payments/v1/payments/direct-charge \
  --header 'Content-Type: application/json' \
  --header 'client-id: <api-key>' \
  --header 'client-secret: <api-key>' \
  --data '{
  "provider": "airtel-smartcash-ng",
  "amount": 100000,
  "reference": "<string>",
  "customerInput": {
    "phoneNumber": "2347012345678"
  },
  "webhook": "https://example.com/webhook"
}'
{
  "data": {
    "reference": "<string>",
    "status": "<string>",
    "sessionId": "<string>",
    "amount": 100000
  }
}

Authorizations

​
client-id
string
header
required
​
client-secret
string
header
required

Body

application/json
​
provider
string
required

This is the provider we are routing the request through. Find full list of providers here Supported Providers

Example:

"provider-slug"

​
amount
integer
required

Amount should be in the subunit of the supported currency i.e value * 100

Example:

100000

​
customerInput
object
required
​
reference
string

A reference code you'll generate to identify this transaction. This must be unique for every transaction. If you don't pass one, we will generate one for you.

​
webhook
string

This is a URL, if this is passed we will send the event webhook payload to this endpoint. Use this to override the webhook url provided on the dashboard for this transaction. Read more on Webhooks

Example:

"https://example.com/webhook"

Response

201 - application/json
Request Submitted Successfully
​
data
object