Auth Payment

Partner API

POST/v1/partner/payments/transactions/:transactionId/authorize

↓Download Swagger

Lets an approved checker authorize or reject a pending transaction created by maker or partner API.

Auth

Header: x-api-key

Use the bank-provisioned partner API key for authentication.

Usage Notes

Header: x-api-key
Checker only
Uses the same approval logic as the product UI

Request Fields

actorUserIdstringrequired

Approved checker's user ID authorizing the transaction.

actionstringrequired

approve or reject.

commentstringoptional

Optional checker note stored on the approval trail.

POST /v1/partner/payments/transactions/txn-1747485000000-001/authorize
x-api-key: fp_test_51H8xKlMnOpQrStUv
Content-Type: application/json

{
  "actorUserId": "user-1780460729021-815",
  "action": "approve",
  "comment": "Budget and beneficiary verified"
}

Sample Success Response

{
  "message": "Transaction authorization applied"
}

Sample Error Response

{
  "type": "invalid_operation_error",
  "title": "The requested operation cannot be performed.",
  "detail": "Invalid transaction state transition.",
  "status": 409
}