POST /collections/authorize — merchant-api

latestOpenAPI 3.0.02026-08-1071532.8 KB

cfd1b00f674f

COLLECTIONS

post/collections/authorize

Headers

public-keystring required

x-api-versionnumber required

Accept-Language'en' | 'fr' | 'sw' required

Request body

internal_referencestring required

Internal/gateway transaction reference

otpnumber required

OTP Auth

Example request

{
  "internal_reference": "DUSUPAYRMGRXNNYBWATKJ",
  "otp": 123456
}

Response

Authorization request accepted.

codenumber required

HTTP Status code

status'success' | 'accepted' | 'error' required

The status of the response

messagestring required

Response messae

dataobject required

Response data

Example response

{
  "code": 202,
  "status": "accepted",
  "message": "Request Accepted",
  "data": {
    "internal_reference": "DUSUPAYRMGRXNNYBWATKJ",
    "merchant_reference": "MCTREFT2WMNWZ23SBN6Y",
    "payment_url": "https://devpay.dusupay.com/pay/collection/DUSUPAYRMGRXNNYBWATKJ"
  }
}