Skip to main content

Update Plan By Alternate Field



Locate a plan by RefOrderNumber or ExtendedParams then carry out post-authorization activities related to the plan, such as updating the order number, updating the tracking number, updating shipping status or updating the amount of the plan (if it hasn't been captured yet). You can also use this endpoint to capture the first installment from a plan that has only been authorized but not yet captured. Note that RefOrderNumber or ExtendedParams were optionally specified by you upon plan creation.


Header Parameters

    X-Splitit-IdempotencyKey string
    X-Splitit-Idempotency-Behaviour string

    Possible values: [DisableReprocessingOnError, AllowReprocessingOnError]

    AllowReprocessingOnError is the default, which means that if you have a failed response or a timeout, the original request is marked as having failed, but a new request can be sent using the same key and will be reprocessed; if you set it to DisableReprocessingOnError, a request with the same key will not be reprocessed after a failure, and if the key is used again, you will get the same error response you got the first time



    RefOrderNumber string
    TrackingNumber string
    Capture boolean
    NewAmount number

    Use to update plan amount if plan amount hasn't been captured yet (i.e. AutoCapture was set to false in the Initiate or Create operation). In addition, 1. amount must be more than original amount 2. first email to customer will be sent upon capture

    ShippingStatus string

    Possible values: [Shipped, Delivered]



    Use the fields in this object to locate your plan

    RefOrderNumber string
    InstallmentPlanNumber string



    property name* string




    RefOrderNumber string
    InstallmentPlanNumber string
    Status stringrequired

    Possible values: [Initialized, PendingCapture, Active, Cleared, Canceled]

    ShippingStatus stringrequired

    Possible values: [Pending, Shipped, Delivered]