POST
/
payments
/
v1
/
payments
/
direct-charge
Direct Charge API
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

Examples:

"provider-slug"

​
amount
integer
required

Amount should be sent in the lowest denomination e.g for 100 USD you should send 100 * 100 = 10000

Examples:

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<uri>

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

Examples:

"https://example.com/webhook"

Response

201 - application/json

Request Submitted Successfully

​
data
object