Void refund | Welcome to cash-app Documentation

{
  "refund": {
    "id": "PWCR_da1v3j4p3z15y47adpzzq0whj",
    "amount": 2500,
    "currency": "USD",
    "customer_id": "AUTH_24g7nq7m1je9b6fnzbtvwzqej",
    "merchant_id": "MMI_4vxs5egfk7hmta3qx2h6rp91x",
    "status": "VOIDED",
    "created_at": "2022-01-01T12:00:00Z",
    "updated_at": "2022-01-05T12:00:00Z",
    "grant_id": "GRG_221243dc6985a6819ff6950c1a21332f7bc4a46ebd49b5a7002908ab768e8e5ff7831e084d0d2c9d8d939793b55eff50",
    "payment_id": "PWC_4nn21zy6t0v2yhqg5bvhk7xkq",
    "reference_id": "external-id",
    "metadata": {
      "my-meta": "meta-value"
    },
    "decline_errors": [
      {
        "category": "INVALID_REQUEST_ERROR",
        "code": "MISSING_REQUIRED_FIELD",
        "detail": "Missing required parameter.",
        "field": "field_a[2].field_b"
      }
    ]
  }
}

Moves an authorized refund to the voided state and removes the “pending refund” screen from a customer’s Cash App account.

You can only void an authorized refund.

This endpoint is not rate limited.

Scopes: REFUNDS_WRITE

Path parameters

refund_idstringRequired

ID of the refund to void.

Response

refundobject

Errors

404

Void Refund Request Not Found Error

Path parameters

Headers

Response

Errors