Transactions

Initialize a payment transaction

POST
/transaction/initialize

Create a new payment session and get a checkout URL to redirect the customer.

Authorization

ApiKeyAuth
Authorization<token>

In: header

Request Body

application/json

amount*integer

Amount in lowest currency unit

email*string
Formatemail
customerPhoneNumber?string
customerFirstName?string
customerLastName?string
currency*string
Value in"NGN" | "USD"
reference?string
callbackUrl?string
Formaturi
channels*array<>
bearer*integer

0 = Customer bears fee 1 = Merchant bears fee

Value in0 | 1
metadata?
narration?string
initializeAccount*integer
Value in0 | 1
pauseSettlement?integer
Value in0 | 1
pauseSettlementDate?string
Formatdate
serviceCode?string
splitConfiguration?array<>

Response Body

application/json

curl -X POST "https://api.credocentral.com/transaction/initialize" \  -H "Content-Type: application/json" \  -d '{    "amount": 0,    "email": "user@example.com",    "currency": "NGN",    "channels": [      "CARD"    ],    "bearer": 0,    "initializeAccount": 0  }'
{
  "status": 0,
  "message": "string",
  "data": {
    "authorizationUrl": "string",
    "reference": "string",
    "credoReference": "string",
    "crn": "string"
  },
  "execTime": 0,
  "error": [
    "string"
  ]
}