Split Shipments

Split shipments enable you to split an order into multiple shipments with multiple captures. You can use this feature when a customer orders a product that is not yet available.

Multiple partial captures and split shipments are not the same feature. The processor provides the multiple partial captures feature, while provides the split shipment feature.

Supported Processors

Requirements for Using Split Shipments

To use split shipments, contact customer support to have your account configured for this feature.

Authorizing a Sale for a Product Not Yet Available

When the customer purchases a product that is not yet available, you can request an authorization and a sale. First request an authorization to ensure that funds are available. After the product becomes available, ship the product and request a sale. then links the follow-on authorization to the first authorization, and then links to the capture request.

Step 1: Requesting an authorization

Request an authorization to ensure that funds are available before the product is available for immediate shipment. The authorization request requires no additional fields or requirements than a basic authorization.

Step 2: Processing a sale

When the product becomes available, ship the product and request a sale. The follow-on authorization requires you to submit a sale request that includes the processingInformation.linkId field in addition to the basic fields required for every sale request. The processingInformation.linkId field in an authorization request triggers the split-shipment functionality.

Set the processingInformation.linkId field to the {id} value from the endpoint.

Field specific to authorizing a sale for a product not yet available:

First Authorization Response: The {id} value is returned in the endpoint.

Follow-on Authorization Request: processingInformation.linkId=SWVdPS5IM

Step 3: attempts to link the follow-on authorization request to the first authorization

• If the processingInformation.linkId value is valid, the follow-on authorization is linked to the original authorization in the and in reports.
• If the processingInformation.linkId value is not valid, the follow-on authorization is not linked to the original authorization in the and in reports.

Step 4: links the capture request

• If the processingInformation.linkId value for the follow-on authorization was valid, all three transactions (first authorization, follow-on authorization, capture) are linked together in the and in reports.
• If the processingInformation.linkId value for the follow-on authorization was not valid, the second authorization and capture are linked to each other in the and in reports, but they are not linked to the first authorization.

See Authorizations for information on how to process a basic authorization. See Sales for information on how to process a sale.

Processing Two Authorizations and a Capture for Multiple Products

When the customer purchases a product that is not yet available, you can request two authorizations and a capture. First request an authorization to ensure that funds are available, and then ship the available products. After the remaining products become available, request follow-on authorization to ensure funds are still available. Ship the remaining products, and request a capture. links the follow-on authorization to the first authorization and the capture request to the other transactions.

Step 1: Requesting an authorization

Request an authorization to ensure that funds are available for one or more of the products that are available for immediate shipment. The authorization request requires no additional fields or requirements than a basic authorization.

Step 2: Requesting a follow-on authorization

After the product becomes available, request a follow-on authorization to ensure that funds are still available. The follow-on authorization request must include the processingInformation.linkId field in addition to the basic fields required for every authorization request. The processingInformation.linkId field in an authorization request triggers the split shipment functionality.

Set the processingInformation.linkId field to the {id} value from the endpoint.

Field specific to requesting a follow-on authorization request:

First Authorization Response: The {id} value is returned in the endpoint.

Follow-on Authorization Request: processingInformation.linkId=SWVdPS5IM

Step 3: attempts to link the follow-on authorization request to the first authorization

• If the processingInformation.linkId value is valid, the follow-on authorization is linked to the original authorization in the and in reports.
• If the processingInformation.linkId value is not valid, the follow-on authorization is not linked to the original authorization in the and in reports.

Step 4: Requesting a capture

You ship the product and request a capture. The capture request requires only the basic fields as any capture request.

Step 5: attempts to link the capture request to the other transactions

All three transactions (first authorization, follow-on authorization, capture) are linked together in the and in reports.

See Authorizations for information on how to process a basic authorization. See Captures for information on how to process a capture.

Processing an Authorization and Two Captures for Multiple Products

When the customer orders multiple products and one is not available, you must request an authorization to ensure funds are available. You ship the products that are available and request a capture for the amount of the shipped products. When the remaining product becomes available, ship the product and request a follow-on capture for the amount of the product. performs a system-generated authorization for the follow-on capture request. then links the capture request. You receive the status of the follow-on capture request and its associated system-generated authorization.

Step 1: Requesting an authorization

Request an authorization to ensure that funds are available for one or more products that are available for immediate shipment. The authorization request requires no additional fields or requirements other than a basic authorization.

Step 2: Requesting a capture

Ship the available product and request a capture while you wait for the remaining product to become available. The capture request requires only the basic fields as any capture request.

Step 3: Requesting a follow-on capture

When the remaining product becomes available, ship it and request a capture for that amount. The capture request requires only the basic fields as any capture request.

Step 4: performs a system-generated authorization

performs a system-generated authorization for the follow-on capture request and link it to the original authorization in the and in reports. processes the capture request as a split shipment request because your account is already enabled for split shipments.

Step 5: attempts to link the capture request to the other transactions

The capture is linked to the authorizations in the and in reports through the request IDs as with any capture. All four transactions (first authorization, system-generated authorization, first capture, follow-on capture) are linked together in the and in reports.

Step 6: provides the status

The status of the follow-on capture request and its associated system-generated authorization becomes available.

See Authorizations for information on how to process a basic authorization. See Captures for information on how to process a capture.