Payment Authorization Error Codes

This document provides a comprehensive reference for payment authorization errors in the Convenient Checkout API. These errors help identify issues with payment authorization, access control, and permissions when managing payments.

Error Codes Summary

Error Code Summary

Error Title Reference	Error Title	HTTP Status	Detail Message	Scenario	Resolution
Payment Authorization
Cross-Merchant Payment Capture	FORBIDDEN	403 FORBIDDEN	Not authorized to capture this payment	When merchant2 attempts to capture a payment initiated by merchant1	Use the same merchant credentials that were used to create the payment
Cross-Merchant Payment Cancellation	FORBIDDEN	403 FORBIDDEN	Not authorized to cancel this payment	When merchant2 attempts to cancel a payment initiated by merchant1	Use the same merchant credentials that were used to create the payment

---

Error Codes Details

Payment Authorization

Cross-Merchant Payment Capture

Scenario: When a merchant tries to capture a payment initiated by a different merchant. The merchant ID is verified against the payment's originating merchant, and if they don't match, the request is rejected.

Sample Request:

POST v1/payments/{paymentId}/capture
X-Merchant-Id: merchant2-uuid
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

{
  "amount": 1,
  "metadata": {
    "property1": "string",
    "property2": "string"
  }
}

Sample Response:

{
  "title": "FORBIDDEN",
  "status": 403
}

Cross-Merchant Payment Cancellation

Scenario: When a merchant tries to cancel a payment initiated by a different merchant. The merchant ID is verified against the payment's originating merchant, and if they don't match, the request is rejected.

Sample Request:

POST v1/payments/{paymentId}/cancel
X-Merchant-Id: merchant2-uuid
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

{
  "paymentCancellationReason": "DUPLICATE",
  "paymentCancellationMessage": "string"
}

Sample Response:

{
  "title": "FORBIDDEN",
  "status": 403
}