DocumentationAPI Reference
API Reference

Creates a contract within Reach.

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.
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.
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.
IssuerInvalidThe specified IssuerId is not recognized by the Reach system.
ConsumerInvalidThe specified Consumer 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