DocumentationAPI Reference
API Reference

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

Error Codes

CodeDescription
RateOfferNotFoundThe RateOfferId did not identify a known, non-expired Reach rate offer.
CurrencyNotFoundThe ConsumerCurrency did not correspond to a supported Reach currency.
CurrencyMismatchThe ConsumerCurrency specified in the request did not match the Currency associated with the specified Reach rate offer.
EmailAddressInvalidThe consumer Email was either invalid or not supplied when required.
PaymentMethodUnsupportedThe PaymentMethod is either not supported by Reach or the merchant has not been approved to use it.
CardNameInvalidThe Name in the card details was not valid.
CardNumberInvalidThe Number in the card details was not valid for the specified payment method
CardYearInvalidThe Year in the card details was not valid
CardMonthInvalidThe Month in the card details was not valid.
CardExpiredThe specified payment card has expired.
CardVerificationCodeInvalidThe VerificationCode in the card details was not valid.
PostalCodeInvalidThe consumer PostalCode was either invalid or not supplied when required.
CountryInvalidThe consumer Country was either invalid or not supplied when required.
AmountInvalidA ConsumerPrice did not meet the requirements documented for the request.
AmountLimitExceededThe request contains an amount that exceeds the amount that Reach is willing to transact in a single order for the merchant.
PaymentAuthorizationFailedThe 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.
BlacklistedThe consumer is on the Reach blacklist and Reach has refused to process the order.
FraudSuspectedBased on the parameters of the order, Reach suspects that the order is fraudulent and/or represents too high a risk to proceed with processing.
ContractNotFoundThe specified ContractId is not associated with the requesting Merchant.
ContractClosedThe specified ContractId is closed and cannot be used to begin new orders.
InstalmentsInvalidA Number was specified for Instalments which is not between 2 and 12 (inclusive).
InstalmentsNotAvailableInstalments were specified, but are not available for the specified card.
BirthDateInvalidThe consumer BirthDate was either invalid or not supplied when required.
NationalIdentifierInvalidThe consumer NationalIdentifier was either invalid or not supplied when required.
PhoneInvalidThe consumer Phone was either invalid or not supplied when required.
RegionInvalidThe consumer Region was either invalid or not supplied when required.
SpotTradeInvalidThe merchant is not configured to perform a spot trade.
CaptureInvalidThe specified value of Capture is not valid for the payment method.
IssuerInvalidThe specified IssuerId is not recognized by the Reach system.
ConsumerTotalInvalidThe ConsumerTotal is not correct.
ContractCurrencyMismatchThe Currency used in this request did not match the currency used to open the specified contract.
ContractPaymentMethodMismatchThe PaymentMethod used in this request did not match the payment method used to open the specified contract.
ContractIssuerMismatchThe Issuer used in this request did not match the issuer used to open the specified contract.
ConsumerInvalidThe specified Consumer is invalid.
ConsigneeInvalidThe specified Consignee is invalid.
OpenContractInvalidThe requested payment method does not support contracts.
AuthenticationRequiredA merchant-initiated order could not be processed because the consumer must be present to authenticate.

Return Error Codes

CodeDescription
PaymentAuthorizationFailedThe payment could not be authorized after the consumer returned from the external site.
PaymentAuthenticationCancelledThe consumer cancelled payment on the external site.
AlreadyCancelledThe order was cancelled before the consumer completed authentication.
PaymentFailedThe payment was authorized but could not be captured.
Language
URL