Update Plan By Alternate Field
PUT/updateorder
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.
Request
Header Parameters
- application/json
Body
required
Possible values: [Shipped
, Delivered
]
Identifier
object
Use the fields in this object to locate your plan
ExtendedParams
object
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": {}
}
}