Update Plan by Number
PUT/:installmentPlanNumber/updateorder
Locate a plan by installment number 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 plan amount (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.
Request
Path Parameters
Header Parameters
- application/json
Body
A merchant-specific identifier value provided at creation of the plan by the merchant
Possible values: [Pending
, Shipped
, Delivered
]
Set this as true
to capture the first payment for a plan that has been authorized but not captured.
Responses
- 200
- 401
- 403
- 404
- 422
- 500
- 400-503
- 400-561
- 400-578
- 400-599
- 400-640
- 400-1041
- 400-5911
Success
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [Initialized
, PendingCapture
, Active
, Cleared
, Canceled
]
Possible values: [Pending
, Shipped
, Delivered
]
{
"RefOrderNumber": "string",
"InstallmentPlanNumber": "string",
"Status": "Initialized",
"ShippingStatus": "Pending"
}
Unauthorized Request: Token is not authorized or is expired
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
Resource Does Not Exist: Plan or service does not exist; for all APIs, if an invalid plan number is passed in the URL, this error will be returned
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
General Server Error: Server encountered an unexpected condition
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
InvalidInstallmentPlanStatus: Status does not allow updating order (example: request capture for plan that was already captured).
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
The input parameters or parameter combination for the updated plan is not supported. (New amount is lower than original amount, can only be higher)
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
InvalidPlanStrategy: We are sorry for the inconvenience, but this plan is not available.
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
General Error: Sorry. There has been an error. Please try again.
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
GtwyMerchantDataProblem: Sorry, but there has been a processing error with this merchant. Please contact our support for assistance.
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
IdempotencyHashMismatchError: Same Idempotency key with different payload identified.
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}
InvalidInternalUrlSentToOms: Plan is not in the correct state to process this request.
- application/json
- Schema
- Example (from schema)
Schema
Error
object
ExtraData
object
{
"TraceId": "string",
"Error": {
"Code": "string",
"Message": "string",
"AdditionalInfo": "string",
"ExtraData": {}
}
}