Refund a payment
POST/api/v1/optimus/payment/:id/refund/
Refund a specific payment.
Request
Path Parameters
id uuidrequired
Responses
- 200
- application/json
- Schema
- Example (from schema)
- ExampleOfResponse
Schema
id uuidrequired
account_alias stringrequired
Possible values: <= 8 characters
first_name stringnullablerequired
Possible values: <= 100 characters
last_name stringnullablerequired
Possible values: <= 100 characters
email stringnullablerequired
Possible values: <= 100 characters
type TypeEnumrequired
Possible values: [request-payment
, transfer
]
amount decimalrequired
Possible values: Value must match regular expression ^-?\d{0,13}(?:\.\d{0,2})?$
reference stringrequired
processing_number stringnullablerequired
mode ModeEnumrequired
Possible values: [mtn-benin
, moov-benin
]
status objectrequired
financial_status objectrequired
completed date-timenullablerequired
processing date-timenullablerequired
failed date-timenullablerequired
created date-timerequired
updated date-timerequired
webhook_url urinullablerequired
Possible values: <= 200 characters
refunded date-timenullablerequired
test booleanrequired
paid_organization booleanrequired
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"account_alias": "string",
"first_name": "string",
"last_name": "string",
"email": "string",
"type": "request-payment",
"amount": "string",
"reference": "string",
"processing_number": "string",
"mode": "mtn-benin",
"status": "completed",
"financial_status": "pending",
"completed": "2024-04-07T02:21:55.077Z",
"processing": "2024-04-07T02:21:55.077Z",
"failed": "2024-04-07T02:21:55.077Z",
"created": "2024-04-07T02:21:55.077Z",
"updated": "2024-04-07T02:21:55.077Z",
"webhook_url": "string",
"refunded": "2024-04-07T02:21:55.077Z",
"test": true,
"paid_organization": true
}
Example of response
{
"id": "d0d0de46737c4fa08853082021344d84",
"account_alias": "67101010",
"amount": "1200.00",
"completed": null,
"created": "2022-09-04T13:45:23.856438Z",
"email": null,
"failed": null,
"financial_status": "pending",
"first_name": null,
"last_name": null,
"mode": "mtn-benin",
"processing": "2022-09-04T13:45:23.859105Z",
"processing_number": null,
"reference": "PYDNGZLTYW",
"refunded": null,
"status": "processing",
"test": false,
"type": "request-payment",
"updated": "2022-09-04T13:45:23.859211Z",
"webhook_url": "https://example.com"
}
Loading...