Sign in

v1

latestOpenAPI 3.0.12026-07-26106359429.8 KB
Instant Payments

Reject return request for an instant payment

Reject the active return request associated with an incoming instant payment. Returns the updated instant payment object with the status of the active return request set to "rejected".

post/v1/instant_payments/{instant_payment_id}/reject_return_request

Path parameters

instant_payment_idstring required

ID of the instant payment object whose return request you want to reject.

Request body

reason'account_closed' | 'non_sufficient_funds' | 'customer_requested' | 'legal_decision' | 'customer_no_response' | 'returned_previously' | 'narrative' required

The reason for rejecting an incoming return request.

  • account_closed - Account closed
  • non_sufficient_funds - Insufficient funds
  • customer_requested - Customer decision
  • legal_decision - Legal decision
  • customer_no_response - No answer from customer
  • returned_previously - Already returned
  • narrative - Narrative reason, additional_information required
additional_informationstring

Accompanying free text explanation for the reason. Required if reason is "narrative".

Example request

{
  "reason": "customer_requested"
}

Response

The updated instant payment object with the return request status set to "rejected".

idstring required

The unique identifier of the instant payment object.

account_idstring required

The ID of the Account object.

account_number_idstring required

The ID of the Lead Bank Account Number object.

direction'outgoing' | 'incoming' required

Who is initiating the transaction.

outgoing: You are sending a transaction to a counterparty. incoming: You are receiving a transaction from a counterparty.

status'created' | 'under_review' | 'canceled' | 'rejected' | 'posted' required

The current status of the instant payment object. If outgoing: created, under_review, canceled, rejected, posted. If incoming: under_review, rejected, posted.

counterparty_status'posted' | 'under_review' | 'rejected' nullable

The current status of the instant payment from the counterparty's perspective. If outgoing: posted, under_review, or rejected. If incoming: posted or null.

amountinteger required

The amount of the instant payment in cents.

currency_code'USD' required

A three-letter currency code as defined in ISO 4217.

descriptionstring

Free-form information on the reason for the payment.

created_atstring date-time required

The ISO 8601 format timestamp that represents when the instant payment object was created.

updated_atstring date-time required

The ISO 8601 format timestamp that represents when the instant payment object was last updated.

Example response

{
  "id": "instant_payment_xyz123",
  "account_id": "account_xyz123",
  "account_number_id": "account_number_xyz123",
  "direction": "outgoing",
  "status": "posted",
  "counterparty_status": "posted",
  "amount": 5000,
  "currency_code": "USD",
  "description": "Payment for invoice 12345",
  "debtor": {
    "name": "Alex Smith",
    "account_number": "1234567890"
  },
  "debtor_agent": {
    "routing_number": "111000111"
  },
  "creditor_agent": {
    "routing_number": "111000111"
  },
  "creditor": {
    "name": "Alex Smith",
    "account_number": "1234567890"
  },
  "payment_identifiers": {
    "end_to_end_id": "033me5upSkktRorr3J6TKZ",
    "uetr": "8dc981d2-e8c2-4a7b-8df0-0781b46328d9",
    "transaction_id": "3G0CQxK8gKLpzaaxc7A9spDiifK"
  },
  "return": {
    "reason": "duplication"
  },
  "rejection": {
    "rejected_by": "lead",
    "reason": "non_sufficient_funds"
  },
  "related_objects": {
    "original_payment_id": "instant_payment_xyz123",
    "return_payment_ids": [
      "instant_payment_xyz456"
    ]
  },
  "return_requests": [
    {
      "status": "pending",
      "reason": "duplicate",
      "deadline": "2022-07-11T23:30:00-04:00",
      "resolution": {
        "resolved_at": "2022-06-27T11:22:33Z",
        "resolved_by": "counterparty",
        "rejection_reason": "customer_no_response"
      },
      "created_at": "2022-06-27T11:22:33Z"
    }
  ],
  "created_at": "2022-06-27T11:22:33Z",
  "updated_at": "2022-06-27T11:22:40Z"
}