API Docs
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

ParameterTypeRequiredDescription
payment_idstringYesThe 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

StatusWhen
400Payment is not in a state that can be rejected (e.g. already settled or cancelled).
404Payment id does not exist.