Sign in
PaymentRequests

Decline payment request

Decline an open incoming payment request

post/payment-requests/{paymentRequestId}/decline

Path parameters

paymentRequestIdstring required

Payment request ID (prq_*).

Headers

Idempotency-Keystring required

Unique key for safely retrying a request without creating duplicates.

X-Instance-IDstring nullable

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Response

Successful Response

Changes

Changed in 5 of the 28 revisions of this API.1113

  • 359d267dca881See the full diff
    • ○

      deleted the header request parameter X-Agent-ID with deprecation

      request-parameter-removed-with-deprecation

  • b1ad79e918ac1See the full diff
    • ○

      header request parameter X-Agent-ID was deprecated

      request-parameter-deprecated

  • ba1fb54c59391See the full diff
    • ○

      added the required property data/attributes/tags to the response with the 200 status

      response-required-property-added

  • 270e233e401c118See the full diff
    • ▲

      the data/attributes/description/anyOf[subschema #1]/ response property's maxLength was unset from 500 for the response status 200

      response-property-max-length-unset

    • ●

      for the header request parameter Idempotency-Key, the maxLength was set to 255

      request-parameter-max-length-set

    • ○

      added the required property data/attributes/initiatorAgent to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/attributes/initiatorParty to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/attributes/payerCanDecline to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/attributes/payerCanPay to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/attributes/payerHandle to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/attributes/requesterHandle to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/attributes/walletName to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/relationships/payerAgent to the response with the 200 status

      response-required-property-added

  • 8cc2aed458472See the full diff
    • ○

      added the required property data/attributes/payerAvatarUrl to the response with the 200 status

      response-required-property-added

    • ○

      added the required property data/attributes/requesterAvatarUrl to the response with the 200 status

      response-required-property-added