AuthorizeRecurringTransaction

Method

AuthorizeRecurringTransaction(AuthorizeRecurringTransactionRequest)

This API method is used by customers who manage their own recurring payment schedules. The operation creates an ACH transaction that includes the required R code in the ACH file, in accordance with NACHA rules for recurring payment authorizations.

note

Recurring Telephone_IVR and Telephone_Operator transactions will not be created if IsBusinessPayment is True (1).

Parameters

TYPE	NAME	DESCRIPTION
AuthorizeRecurringTransactionRequest	request

Returns

TYPE	DESCRIPTION
AuthorizeRecurringTransactionResponse

Example Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:pv="https://ssl.selectpayment.com/PV">
   <soapenv:Header>
      <pv:SecurityHeader>
         <pv:BinarySecurityToken>your security token here</pv:BinarySecurityToken>
      </pv:SecurityHeader>
   </soapenv:Header>
		
		<soapenv:Body>
		<pv:AuthorizeRecurringTransaction>
			<pv:customer>
				<pv:storeId>0</pv:storeId>
				<pv:storeKey isNull="false"/>
				<pv:EntityId>12345</pv:EntityId>
				<pv:IsCompany>0</pv:IsCompany>
				<pv:CustomerNumber>111222333</pv:CustomerNumber>
				<pv:FirstName>Name</pv:FirstName>
				<pv:LastName>Name</pv:LastName>
			</pv:customer>
			<pv:createCustomerIfDoesNotExists>1</pv:createCustomerIfDoesNotExists>
			<pv:updateCustomerIfExists>0</pv:updateCustomerIfExists>
			<pv:recurringTransaction>
				<pv:EntityId>123456</pv:EntityId>
				<pv:LocationId>10606</pv:LocationId>
				<pv:RecurringPaymentOrigin>Telephone_Operator</pv:RecurringPaymentOrigin>
				<pv:EffectiveDate>2026-01-06</pv:EffectiveDate>
				<pv:Description>Recurring</pv:Description>
				<pv:TotalAmount>50.00</pv:TotalAmount>
				<pv:TransactionNumber>111</pv:TransactionNumber>
				<pv:RoutingNumber>1112223333</pv:RoutingNumber>
				<pv:AccountNumber>123445567</pv:AccountNumber>
				<pv:IsBusinessPayment>0</pv:IsBusinessPayment>
				<pv:NameOnAccount>Example Acount Name</pv:NameOnAccount>
			</pv:recurringTransaction>
		</pv:AuthorizeRecurringTransaction>
	</soapenv:Body>
</soapenv:Envelope>

Example Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<soap:Body>
		<AuthorizeRecurringTransactionResponse xmlns="https://ssl.selectpayment.com/PV">
			<AuthorizeRecurringTransactionResult>
				<ReferenceNumber>T:R9388BX8A1</ReferenceNumber>
				<Success>true</Success>
				<Error>false</Error>
				<ResponseCode>Success</ResponseCode>
				<ActualDate>2012-01-06T00:00:00-06:00</ActualDate>
				<ResponseMessage/>
				<OriginatedAs>ACH</OriginatedAs>
			</AuthorizeRecurringTransactionResult>
		</AuthorizeRecurringTransactionResponse>
	</soap:Body>
</soap:Envelope>