API/Services/TokeniseCreditCard

From Emersion
Jump to: navigation, search

Purpose

This allow customer to store credit card in to EPS and generate token for a secure way of making / requesting payment.

Inputs

  <soapenv:Header/>
  	<soapenv:Body>
     		<ser:TokeniseCreditCardRequest>
               <ser:TokeniseCreditCard account_id="511596" card_type="Visa" card_name="Customer Name" card_number="4444333322221111" card_expiry="6/2015" card_cvv="123" automated_payment_configuration="1" />
               </ser:TokeniseCreditCardRequest>
  	</soapenv:Body>

Description

Required attribute:

  • automated_payment_configuration = Type positive integer option:
    • 1 = One off payment (Default).
    • 2 = One off payment and set as default payment.
    • 3 = Set as default payment and enable recurring charges.
  • account_id = Type positive integer
  • Card_type = Type Option
    • Visa
    • MasterCard
    • American Express
    • Diners
  • card_name = Type string at least 1 character
  • card_number = Type string must be a valid card credit card number based on the card_type
  • card_expiry = Type date format mm/YYYY
  • card_cvv = Type non negative integer

Output

  <SOAP-ENV:Body>
     <ns1:TokeniseCreditCardResponse>
     <ns1:CreditCardTokenResponse>
      305889725747721480112620601729009174294547589547C
     </ns1:CreditCardTokenResponse>
     </ns1:TokeniseCreditCardResponse>
  </SOAP-ENV:Body>

Error String

148.Payment gateway has not been initialised

149.Required TokeniseCreditCard' element

150.Invalid account ID ['.$requestDetails->account_id.'].

151.Account provided is not currently active.

152.Required credit card type

153.Required credit card number

154.Required credit card holder name

155.Required credit card expiry date

156.Credit Card provided expired.

157.Invalid credit card expiry date

158.Required credit card security number / cvv

159.Credit card type ['.$requestDetails->card_type.'] is currently not supported. Please try another card.

160.Invalid Credit Card Details.

161.Unable to process credit card. '.$request->getError());


  • Please note: This API call requires access to an additional Account Feature (Integration Payment). Please contact | Emersion Support if you are receiving the following message;
Tokenise Credit Card feature is currently not enable for this account. Please contact support for more details.