HomeDocumentationAPI Reference
API Reference

/checkout

Creates a merchant's order within Reach and attempts authorization of the payment.

Error Codes

Code

Description

RateOfferNotFound

The RateOfferId did not identify a known, non-expired Reach rate offer.

CurrencyNotFound

The ConsumerCurrency did not correspond to a supported Reach currency.

CurrencyMismatch

The ConsumerCurrency specified in the request did not match the Currency associated with the specified Reach rate offer.

EmailAddressInvalid

The consumer Email was either invalid or not supplied when required.

PaymentMethodUnsupported

The PaymentMethod is either not supported by Reach or the merchant has not been approved to use it.

CardNameInvalid

The Name in the card details was not valid.

CardNumberInvalid

The Number in the card details was not valid for the specified payment method

CardYearInvalid

The Year in the card details was not valid

CardMonthInvalid

The Month in the card details was not valid.

CardExpired

The specified payment card has expired.

CardVerificationCodeInvalid

The VerificationCode in the card details was not valid.

PostalCodeInvalid

The consumer PostalCode was either invalid or not supplied when required.

CountryInvalid

The consumer Country was either invalid or not supplied when required.

AmountInvalid

A ConsumerPrice did not meet the requirements documented for the request.

AmountLimitExceeded

The request contains an amount that exceeds the amount that Reach is willing to transact in a single order for the merchant.

PaymentAuthorizationFailed

The payment processing provider, or an intermediary, refused to authorize the payment despite the details being syntactically correct. For example, the payment processor's fraud checks may have failed or the payment processor may have been unable to validate authentication.

Blacklisted

The consumer is on the Reach blacklist and Reach has refused to process the order.

FraudSuspected

Based on the parameters of the order, Reach suspects that the order is fraudulent and/or represents too high a risk to proceed with processing.

ContractNotFound

The specified ContractId is not associated with the requesting Merchant.

ContractClosed

The specified ContractId is closed and cannot be used to begin new orders.

InstalmentsInvalid

A Number was specified for Instalments which is not between 2 and 12 (inclusive).

InstalmentsNotAvailable

Instalments were specified, but are not available for the specified card.

BirthDateInvalid

The consumer BirthDate was either invalid or not supplied when required.

NationalIdentifierInvalid

The consumer NationalIdentifier was either invalid or not supplied when required.

PhoneInvalid

The consumer Phone was either invalid or not supplied when required.

RegionInvalid

The consumer Region was either invalid or not supplied when required.

SpotTradeInvalid

The merchant is not configured to perform a spot trade.

CaptureInvalid

The specified value of Capture is not valid for the payment method.

IssuerInvalid

The specified IssuerId is not recognized by the Reach system.

ConsumerTotalInvalid

The ConsumerTotal is not correct.

ContractCurrencyMismatch

The Currency used in this request did not match the currency used to open the specified contract.

ContractPaymentMethodMismatch

The PaymentMethod used in this request did not match the payment method used to open the specified contract.

ContractIssuerMismatch

The Issuer used in this request did not match the issuer used to open the specified contract.

ConsumerInvalid

The specified Consumer is invalid.

ConsigneeInvalid

The specified Consignee is invalid.

ConsentRequired

Consent is required from the consumer to proceed, but was not provided.

OpenContractInvalid

The requested payment method does not support contracts.

AuthenticationInvalid

A ViaAgent order could not be processed because the consumer must be present to authenticate.

Return Error Codes

Code

Description

PaymentAuthorizationFailed

The payment could not be authorized after the consumer returned from the external site.

PaymentAuthenticationCancelled

The consumer cancelled payment on the external site.

AlreadyCancelled

The order was cancelled before the consumer completed authentication.

PaymentFailed

The payment was authorized but could not be captured.

Language
URL