Guaranteed Payments - Required Elements

You must code to the cnpAPI V12.24 or higher to use Guaranteed Payments. Please contact your Relationship Manager for additional information.

Your Authorization or Sale transaction must include the following optional elements, except as noted, for the Guaranteed Payments service to process a successful fraud check with Signifyd and receive a fraud decision:

Children of authorization or sale:

• orderId

• orderChannel

• merchantCategoryCode (if approved for Dynamic MCC)

Children of billToAddress and shipToAddress

• email

• addressLine1, addressLine2, addressLine3

• city

• zip

Children of customerInfo

• accountUsername

• accountCreatedDate

• membershipName

Children of lineItemData

• productName

• lineItemTotal

• quantity

• productId

Children of cardholderAuthentication

• customerIpAddress

• webSessionId (not required if transaction is MIT or MOTO)

Child of advancedFraudChecks

• webSessionId

Guaranteed Payments - Needed Elements

Inclusion of the following element ensures Worldpay can provide a fraud guarantee on each transaction. Although the need for each element varies according to your use case, if you omit a needed field, Worldpay may not be able to offer the fraud guarantee. Best practices indicate you should code to include these fields in your Authorization or Sale transactions. For more specific information, please speak to your Implementation Manager.

Children of billToAddress and shipToAddress

You can include either firstName, middleInitial, and lastName OR name. You do not need to include both.

• email

• addressLine1, addressLine2, addressLine3

• city

• zip

• lastName (billToAddress only)

• name (billToAddress only)

Children of customerInfo

• accountUsername
• userAccountEmail (not needed for guest checkout)
• userAccountPhone (not needed for guest checkout)

Children of lineItemData

• deliveryType

• discountCode (include if applicable)

• discountAmount or discountPercent (include one of these elements if you include discountCode)

• shippingAmount

• fulfillmentMethodType

Children of lineItemData

• itemCategory

• itemSubCategory

• productId

• productCode

Children of sellerInfo

If the order is not associated with a third party, you do not need to include these children of sellerInfo.

• accountNumber

• aggregateOrderCount

• aggregateOrderDollars

• sellerStreetAddress

• sellerPostalCode

• sellerCite

• sellerProvinceCode

• sellerCountryCode

• createDate

• domain

• email

• lastUpdateDate

• name