HomeDocumentationAPI Reference
API Reference

/authorize

Authorize payment for an order. This requires that the specified order has been created but not authorized yet.

Error Codes

Code

Description

AlreadyCancelled

The Reach order has automatically expired and cannot be authorized.

AlreadyDeclined

The Reach order has already been declined and cannot be authorized.

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.

ContractClosed

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

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.

InstalmentsNotAvailable

Instalments were requested in the call to checkout but are not available to the card specified.

CaptureInvalid

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

IssuerInvalid

The specified IssuerId is not recognized by the Reach system.

OrderStateInvalid

The order is not in a state that allows authorization.

PaymentMethodUnsupported

The specified payment method is not supported.

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.

ContractNotFound

The specified ContractId is not associated with the requesting Merchant.

ConsumerTotalInvalid

The ConsumerTotal is not correct.

ConsentRequired

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

OpenContractInvalid

The requested payment method does not support contracts.

AuthenticationRequired

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

Language
URL