Payments
API ReferencePaymentsReject
Reject Payment
Rejects a payment that was held for manual review by a fraud or risk decision rule. Rejecting voids the authorization and the customer is not charged.
POST /payments/:payment_id/reject
This endpoint takes no request body. The path parameter is the only input.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
payment_id | string | Yes | The ID of the payment to reject. The payment must be in a manual-review state. |
Request Example
curl -X POST 'https://api.v2.paychtec.com/payments/pay_1234567890abcdef/reject' \ -H "Content-Type: application/json" \ -H "api-key: snd_YOUR_API_KEY"Response
{
"payment_id": "pay_1234567890abcdef",
"status": "failed",
"amount": 6540,
"currency": "USD",
"error_code": "manual_review_rejected",
"error_message": "Payment rejected by merchant"
}Errors
| Status | When |
|---|---|
400 | Payment is not in a state that can be rejected (e.g. already settled or cancelled). |
404 | Payment id does not exist. |