Split Shipments Processing
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.
IMPORTANT
Split shipments are not available for
Mastercard transactions in the IDR currency on
Visa Platform Connect
.Multiple partial captures
and split shipments
are not the same feature.
The processor provides the multiple partial captures feature, while Cybersource
provides the split shipment feature.Requirements for Using Split Shipments
The requirements for using split shipments are you must use
Visa Platform Connect
and contact customer support to have your account
configured for this feature. IMPORTANT
A
Visa Platform Connect
account can only be enabled for
either the multiple partial captures or split shipments feature, but not
both.
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.
Cybersource
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:
Cybersource
attempts to link the follow-on authorization request to the first authorization
-
If theprocessingInformation.linkIdvalue is valid, the follow-on authorization is linked to the original authorization in theBusiness Centerand in reports.
-
If theprocessingInformation.linkIdvalue is not valid, the follow-on authorization is not linked to the original authorization in theBusiness Centerand in reports.
Step 4:
Cybersource
links the capture request
-
If theprocessingInformation.linkIdvalue for the follow-on authorization was valid, all three transactions (first authorization, follow-on authorization, capture) are linked together in theBusiness Centerand in reports.
-
If theprocessingInformation.linkIdvalue for the follow-on authorization was not valid, the second authorization and capture are linked to each other in theBusiness Centerand in reports, but they are not linked to the first authorization.
Related Information
-
See Basic 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.
Cybersource
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:
Cybersource
attempts to link the follow-on authorization request to the first authorization
-
If theprocessingInformation.linkIdvalue is valid, the follow-on authorization is linked to the original authorization in theBusiness Centerand in reports.
-
If theprocessingInformation.linkIdvalue is not valid, the follow-on authorization is not linked to the original authorization in theBusiness Centerand 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:
Cybersource
attempts to link the capture request to the other transactions
All three transactions (first authorization, follow-on authorization, capture) are linked together in the
Business Center
and in reports.
Related Information
-
See Basic 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.
Cybersource
performs a system-generated authorization for the follow-on capture request.
Cybersource
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:
Cybersource
performs a system-generated authorization
Cybersource
performs a system-generated authorization for the follow-on capture request and link it to the original authorization in the
Business Center
and in reports.
Cybersource
processes the capture request as a split shipment request because your account is already enabled for split shipments.
Step 5:
Cybersource
attempts to link the capture request to the other transactions
The capture is linked to the authorizations in the
Business Center
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
Business Center
and in reports.
Step 6:
Cybersource
provides the status
The status of the follow-on capture request and its associated system-generated authorization becomes available.
Related Information
-
See Basic Authorizations for information on how to process a basic authorization.
-
See Captures for information on how to process a capture.