Skip to main content
POST
/
payments
/
v1
/
payments
/
direct-charge
Collection API - Direct
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": "<string>",
  "amount": 100000,
  "customerInput": {
    "phoneNumber": "2347012345678"
  },
  "reference": "<string>",
  "redirectURL": "https://example.com/redirect/success",
  "webhook": "https://example.com/webhook",
  "metadata": {
    "merchantName": "Karis Clothing",
    "trafficType": "ECOMMERCE"
  }
}
'
{
  "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:

"airtel-smartcash-ng"

"mtn-momo-ivory-coast"

​
amount
integer<int64>
required

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

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.

​
redirectURL
string<uri>

Fully qualified URL to which the customer should be redirected after the payment is completed

Example:

"https://example.com/redirect/success"

​
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

Example:

"https://example.com/webhook"

​
metadata
object

Response

201 - application/json

Request Submitted Successfully

​
data
object