Afterpay Get Configuration

Overview

An Afterpay GetConfiguration call is made to retrieve configuration data for a given web store by tender. The store and tender combination will be used to determine which gateway's configurations to return.

For details of the Afterpay payment workflow, see Afterpay Processing.

URI Summary

Action	URI Template	URI Example	Non-URI Request	Response
POST	/vM.m/stores/[StoreId]/payments/configuration/get/[Tender].xml	/vM.m/stores/TMSUS/payments/configuration/get/AF.xml	XML	200 + XML Response containing the configuration values

Request Elements

Element	Required	Description	Type	Restriction
/GetConfigurationRequest/@requestId	Yes	RequestId is used to uniquely identify a request, including as part of idempotent duplicate request processing. The value must be unique. It is recommended to use a variant 4 UUID for the request ID. The same request ID should only be reused if a read timeout occurs when attempting to receive a response from the payment service, or the payment service responds with a fault response. In all other cases a new request ID must be sent for retried requests, including responses such as Fail, Timeout or PaymentProcessorTimeout.	String	Up to 40 characters

Request Example

Copy this code sample.

<?xml version="1.0" encoding="UTF-8"?>
<GetConfigurationRequest xmlns="http://api.gsicommerce.com/schema/checkout/1.0" requestId="1234567"/>

Response Elements

Element	Required	Description	Type	Restriction
ResponseCode	Yes	ResponseCode of the GetConfiguration request. Includes Success, Fail, and Timeout.	String	Enumeration: Success, Fail, Timeout
AfterpayConfiguration	No	A collection of Afterpay Configuration values. There can be more than one Afterpay Configuration per response.	ComplexType
AfterpayConfiguration/PaymentType	No	The type of payment this configuration is for. Currently Afterpay supports only one payment type, PAY_BY_INSTALLMENT, so this value is always returned in the reply for both the v1 and v2 version of the Afterpay API.	String
AfterpayConfiguration/MinimumAmount	Yes	The minimum amount that must be used for a transaction using this configuration to be valid. Represented by a decimal currency with two decimal points.	String
AfterpayConfiguration/MinimumAmount/@currencyCode	Yes	Type of currency used for the MinimumAmount.	String	3-character ISO 4217 code (for example, USD, CAD, EUR). See http://en.wikipedia.org/wiki/ISO_4217.
AfterpayConfiguration/MaximumAmount	Yes	The maximum amount that can be used for a transaction using this configuration to be valid. Represented by a decimal currency with two decimal points.	String
AfterpayConfiguration/MaximumAmount/@currencyCode	Yes	Type of currency used for the MaximumAmount.	String	3-character ISO 4217 code (for example, USD, CAD, EUR). See http://en.wikipedia.org/wiki/ISO_4217.
AfterpayConfiguration/ExpirationDateTime	No	The date and time at which this configuration will expire and no longer be valid.	dateTime

Success Response Example

Copy this code sample.

<?xml version="1.0" encoding="UTF-8"?>
<GetConfigurationReply xmlns="http://api.gsicommerce.com/schema/checkout/1.0"
        xmlns:payment="http://schema.gsicommerce.com/payments/types/1.0/">
    <ResponseCode>Success</ResponseCode>
    <AfterpayConfiguration>
        <PaymentType>Installment</PaymentType>
        <MinimumAmount currencyCode="USD">99.99</MinimumAmount>
        <MaximumAmount currencyCode="USD">500.00</MaximumAmount>
        <ExpirationDateTime>2018-11-24T11:59:59Z</ExpirationDateTime>
    </AfterpayConfiguration>
</GetConfigurationReply>

Success Response Example With Multiple Configurations

Copy this code sample.

<?xml version="1.0" encoding="UTF-8"?>
<GetConfigurationReply xmlns="http://api.gsicommerce.com/schema/checkout/1.0"
        xmlns:payment="http://schema.gsicommerce.com/payments/types/1.0/">
    <ResponseCode>Success</ResponseCode>
    <AfterpayConfiguration>
        <PaymentType>Installment</PaymentType>
        <MinimumAmount currencyCode="USD">99.99</MinimumAmount>
        <MaximumAmount currencyCode="USD">500.00</MaximumAmount>
        <ExpirationDateTime>2018-11-24T11:59:59Z</ExpirationDateTime>
    </AfterpayConfiguration>
    <AfterpayConfiguration>
        <PaymentType>Credit</PaymentType>
        <MinimumAmount currencyCode="USD">1.99</MinimumAmount>
        <MaximumAmount currencyCode="USD">100.00</MaximumAmount>
        <ExpirationDateTime>2018-11-24T11:59:59Z</ExpirationDateTime>
    </AfterpayConfiguration>
</GetConfigurationReply>

Failure Response Example

Copy this code sample.

<?xml version="1.0" encoding="UTF-8"?>
<GetConfigurationReply xmlns="http://api.gsicommerce.com/schema/checkout/1.0"
        xmlns:payment="http://schema.gsicommerce.com/payments/types/1.0/">
    <ResponseCode>Fail</ResponseCode>
</GetConfigurationReply>

Timeout Response Example

Copy this code sample.

<?xml version="1.0" encoding="UTF-8"?>
<GetConfigurationReply xmlns="http://api.gsicommerce.com/schema/checkout/1.0"
        xmlns:payment="http://schema.gsicommerce.com/payments/types/1.0/">
    <ResponseCode>Timeout</ResponseCode>
</GetConfigurationReply>