Afterpay / Clearpay
Afterpay is an interest-free Buy Now Pay Later product. Consumers can choose to Pay-in-4 interest-free instalments or, for qualified Afterpay consumers, an additional repayment option during checkout allows them to pay over 6 or 12 monthly instalments, available exclusively for US consumers. With a global payback rate of 95% early or on time, transparent spending limits, and capped late fees, Afterpay aims to unlock growth for merchants and prevent overspending for the consumer. In the UK, Afterpay operates under the name ClearPay.
Payment Method Properties
Available country codes | US, GB |
Processing (Presentation) currencies | USD, GBP |
Settlement currencies | USD, GBP |
Consumer currencies | USD, GBP |
Channel member tag | afterpay |
Scheme name in the settlement file | Afterpay/Clearpay |
Minimum transaction amount | USD 1 (Pay-in-4) USD 400 (Monthly Payments) GBP 1 (Pay-in-4) |
Maximum transaction amount | USD 2,000 (Pay-in-4) USD 4,000 (Monthly Payments) GBP 1,200 (Pay-in-4) |
Session timeout | 4 hours |
Refund | Full Partial Multiple partial |
Refund Validity | 120 days |
Chargeback | Yes |
Integration Type | Asynchronous |
Sandbox | PPRO-hosted |
Disputes / Chargebacks
A consumer could raise a dispute with Afterpay or chargeback with their issuer when they are unable to resolve the situation directly with the merchant. Afterpay will subsequently submit a request to PPRO inquiring about the transaction. PPRO notifies the PSP/merchant to provide full details and supporting documents for dispute/chargeback. The PSP/merchant is required to provide a response to PPRO within 7 business days. If the case is ruled in the favour of the consumer, the funds for the dispute/chargeback will then be deducted from one of PPRO’s next settlements. For more information see the Afterpay Chargebacks.
Transaction Flow
PPRO supports the immediate payment flow. The entire order total will be captured in full automatically as part of the transaction call.
- The consumer selects to pay with Afterpay in the merchant checkout
- The merchant sends the Transaction request to the PSP
- PSP sends the Transaction request to PPRO
- A Create Checkout Request is sent to Afterpay
- A Create Checkout Response is returned along with the redirect checkout URL
- A redirect URL is built and sent to the PSP
- PSP sends redirect URL to Merchant
- Merchant forwards the redirect URL to the consumer's browser
- Consumer is shown the Afterpay page to sign-in/sign-up and approve the order
- Afterpay notify PPRO of order status
- A Capture Full Payment request is sent to Afterpay automatically and immediately by PPRO
- A Capture Full Payment response is returned indicating the status of the capture
- PPRO redirects the consumer back to the merchant’s web page and displays the result
- A notification is sent to the PSP informing of a status update
Integration
Specific input parameters for the TRANSACTION call
Field Name | M/O/C | Type | Regex | Description |
---|---|---|---|---|
specin.email | M | String | .* | Consumer's email |
specin.orderid | M | String | .* | Merchant order reference number (ID) provided to consumer |
specin.billingaddrfirstname | O M - if billing object is present | String | .* | Billing first name Recommended field to pass as it may improve approval and conversion rates |
specin.billingaddrlastname | O M - if billing object is present | String | .* | Billing last name Recommended field to pass as it may improve approval and conversion rates |
specin.billingaddrline1 | O M - if billing object is present | String | .* | First line of the billing address Recommended field to pass as it may improve approval and conversion rates |
specin.billingaddrline2 | O | String | .* | Second line of the billing address |
specin.billingadminarea1 | O M - if billing object is present | String | .* | US, UK: City Recommended field to pass as it may improve approval and conversion rates |
specin.billingadminarea2 | O | String | .* | UK only: Suburbs |
specin.billingregion | O M - if billing object is present | String | .* | US: State UK: County Recommended field to pass as it may improve approval and conversion rates |
specin.billingaddrpostalcde | O M - if billing object is present | String | .* | ZIP or postal code of the billing address Recommended field to pass as it may improve approval and conversion rates |
specin.billingcntrycde | O M - if billing object is present | String | .* | The two-character ISO 3166-1 country code Recommended field to pass as it may improve approval and conversion rates |
specin.shippingaddrfirstname | O M - if shipping object is present | String | .* | Shipping first name Recommended field to pass as it may improve approval and conversion rates |
specin.shippingaddrlastname | O M - if shipping object is present | String | .* | Shipping last name Recommended field to pass as it may improve approval and conversion rates |
specin.shippingaddrline1 | O M - if shipping object is present | String | .* | First line of the shipping address Recommended field to pass as it may improve approval and conversion rates |
specin.shippingaddrline2 | O | String | .* | Second line of the shipping address |
specin.shippingadminarea1 | O M - if shipping object is present | String | .* | US, UK: City Recommended field to pass as it may improve approval and conversion rates |
specin.shippingadminarea2 | O | String | .* | UK only: Suburbs |
specin.shippingregion | O M - if shipping object is present | String | .* | US: State UK: County Recommended field to pass as it may improve approval and conversion rates |
specin.shippingaddrpostalcde | O M - if shipping object is present | String | .* | ZIP or postal code of the shipping address Recommended field to pass as it may improve approval and conversion rates |
specin.shippingcntrycde | O M - if shipping object is present | String | .* | The two-character ISO 3166-1 country code Recommended field to pass as it may improve approval and conversion rates |
transientin.orderitems | O | String | Stringified JSON array | An array of items in the consumer's cart that is being purchased, where each item has the following attributes: name : the name of the item price - unit price of the item (note: in major units) quantity: quantity of the item bought, in integer currency - currency of the unit price, ISO-4217 format For example: [{"name":"Blue Carabiner","quantity":1,"price":" 40.00","currency":"USD"},{"name":"Jeans","quantity":1," price":"20.00","currency":"USD"}] In the above example, there are two items in the basket as shown below. Item 1 Name: Blue Carabiner Quantity: 1 Unit price: 40.00 Currency: USD Item 2 Name: Jeans Quantity: 1 Unit price: 20.00 Currency: USD Recommended field to pass as it may improve approval and conversion rates and help in investigation, if any dispute/chargeback arises |
For standard input parameters, see Input parameters for the TRANSACTION call.
Specific output parameters for the TRANSACTION call
Field Name | Type | Description |
---|---|---|
specout.minAmt | String | The minimum amount returned from the Get Configuration call from Afterpay May not be included if the Merchant account has no minimum order amount |
specout.maxAmt | String | The maximum amount returned from the Get Configuration call from Afterpay |
specout.orderid | String | Merchant reference number (ID) provided to consumer |
For standard output parameters, see Output parameters for the TRANSACTION call.
TRANSACTION call input
tag=afterpay
&txtype=TRANSACTION
&countrycode=US
¤cy=USD
&amount=1000
&merchanttxid=sale1709888865732
&login=LOGIN
&password=password
&contractid=MERCHANT
&channel=livechannel
&merchantredirecturl=https%3A%2F%2Fwww.example.org%2Ffeedback.php
¬ificationurl=https%3A%2F%2Fwww.example.org%2Fnotification.php
&accountholdername=Test User
&specin.email=test.tester%40testing.com%0A
&specin.billingaddrfirstname=First
&specin.billingaddrlastname=Last
&specin.billingaddrline1=123 Test Street
&specin.billingaddrline2=Apartment 1
&specin.billingadminarea1=Los Angeles
&specin.billingregion=California
&specin.billingaddrpostalcde=90210
&specin.billingcntrycde=US
&specin.shippingaddrfirstname=First
&specin.shippingaddrlastname=Last
&specin.shippingaddrline1=123 Test Street
&specin.shippinggaddrline2=Apartment 1
&specin.shippingadminarea1=Los Angeles
&specin.shippingregion=California
&specin.shippingaddrpostalcde=90210
&specin.shippingcntrycde=US
&transientin.orderitems=[{"name":"Blue Carabiner","quantity":1,"price":"40.00","currency":"USD"},{"name":"Jeans","quantity":1,"price":"20.00","currency":"USD"}]
&returnmode=urlencodeext
TRANSACTION call output
REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=123887123
&ERRMSG=
&CHANNEL=livechannel
&MERCHANTTXID=sale1709888865732
&TAG=afterpay
&SPECOUT.MINAMT=1
&SPECOUT.MAXAMT=2000.00
&SPECOUT.ORDERID=order123
&REDIRECTSECRET=dcn94nd2oud8eedhg38dkhed
&FUNDSSTATUS=WAITING
&FLAGS=
Updated about 1 month ago