Teleingreso Deposit (Telepay)

TeleIngreso is a voucher based payment method that is used in Spain, Portugal, Mexico and the US (currently being researched & not yet supported at PXP Financial).

Supported currencies are thus EUR and MXN.

The provider claims to support purchasing a TeleIngreso code with Bitcoin (soon).

The following method IDs are covered in this section:

ID

Name

Credit/Debit State

Reversal State

237

Teleingreso Deposit

DepositedByProvider (29)

Payment method interaction type: Synchronous Execution (see Interaction Types).

With TeleIngreso a certificate (voucher) is issued and is paid by the customer within a certain pre-defined expiration time. When the expiration time is not sent or defined by the merchant, the default expiration time of 4 days applies.

Issued certificates cannot be re-used for a second payment (while still valid). Also certificates do not allow payment with other amounts than the issued amount. Users cannot share certificates as only the real user will receive the purchase associated with the certificate.

Chargebacks are not possible.

Redirect Integration

Currently not supported.

Backend2BackendIntegration

The following table contains the fields to be sent in the initiatePaymentRequest.specificPaymentAccountData xml section:

key (value type, account type, required)

value

ExpirationDate (datetime)

If the merchant will not send it, it can be configured as payment creation day plus some pre-defined time (e.g. 6 days)

Example initiatePaymentRequest for EUR:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <merchantID>KalixaAcceptDemo</merchantID>
  <shopID>KalixaAcceptDemo</shopID>
  <merchantTransactionID>pt-eur-00019-04</merchantTransactionID>
  <paymentMethodID>237</paymentMethodID>
  <amount currencyCode="EUR">24.01</amount>
  <userID>TeleIngresoPTUserEUR</userID>
  <userIP>127.0.0.1</userIP>
  <userSessionID>dfcf02a0-3dd1-496c-b76e-55d1a521494a</userSessionID>
  <creationTypeID>1</creationTypeID>
  <specificPaymentData>
    <data xsi:type="keyDateTimeValuePair">
      <key>ExpirationDate</key>
      <value>2017-04-02T23:15:00</value>
    </data>
  </specificPaymentData>
</initiatePaymentRequest>

Example initiatePaymentResponse for EUR payment:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <payment xsi:type="paymentWithPaymentAccount" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <merchantID>KalixaAcceptDemo</merchantID>
    <shopID>KalixaAcceptDemo</shopID>
    <paymentMethod>
      <key>237</key>
      <value>TeleIngresoDeposit</value>
    </paymentMethod>
    <merchantTransactionID>pt-eur-00019-04</merchantTransactionID>
    <paymentID>dba87170-5e38-4bc2-84ba-d4fe78efea3a</paymentID>
    <userID>TeleIngresoPTUserEUR</userID>
    <paymentProvider>
      <key>153</key>
      <value>TelePay</value>
    </paymentProvider>
    <amount currencyCode="EUR">24.01</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>526eb541-ce2d-49cf-9e04-acb0a493a565</id>
      <definition>
        <key>3</key>
        <value>InitiatedByProvider</value>
      </definition>
      <createdOn>2017-05-08T13:26:28.542043Z</createdOn>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderResponseCode</key>
          <value>0</value>
        </detail>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderResponseMessage</key>
          <value>Accepted</value>
        </detail>
        <detail xsi:type="keyStringValuePair">
          <key>PaymentStateReasonID</key>
          <value>1</value>
        </detail>
      </paymentStateDetails>
    </state>
    <isExecuted>false</isExecuted>
    <baseAmount currencyCode="EUR">24.01</baseAmount>
    <paymentDetails>
      <detail xsi:type="keyDateTimeValuePair">
        <key>ExpirationDate</key>
        <value>2017-04-03T00:15:00</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>CertificateNumber</key>
        <value>654930298</value>
      </detail>
    </paymentDetails>
    <paymentAccount>
      <paymentAccountID>0</paymentAccountID>
    </paymentAccount>
  </payment>
</initiatePaymentResponse>

Example initiatePaymentRequest for MXN payment:

<initiatePaymentRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <merchantID>KalixaAcceptDemo</merchantID>
  <shopID>KalixaAcceptDemo</shopID>
  <merchantTransactionID>pt-mxn-00030-01</merchantTransactionID>
  <paymentMethodID>237</paymentMethodID>
  <amount currencyCode="MXN">11.00</amount>
  <userID>TeleIngresoPTUserMXN</userID>
  <userIP>127.0.0.1</userIP>
  <userSessionID>dfcf02a0-3dd1-496c-b76e-55d1a521494a</userSessionID>
  <creationTypeID>1</creationTypeID>
  <specificPaymentData>
    <data xsi:type="keyDateTimeValuePair">
      <key>ExpirationDate</key>
      <value>2017-04-01T23:15:00</value>
    </data>
  </specificPaymentData>
</initiatePaymentRequest>

Example initiatePaymentResponse for MXN payment:

In the case of MXN payment, a bar code URL and Paynet code are returned.

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <payment xsi:type="paymentWithPaymentAccount" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <merchantID>KalixaAcceptDemo</merchantID>
    <shopID>KalixaAcceptDemo</shopID>
    <paymentMethod>
      <key>237</key>
      <value>TeleIngresoDeposit</value>
    </paymentMethod>
    <merchantTransactionID>pt-mxn-00030-01</merchantTransactionID>
    <paymentID>5173bc4b-b2df-426d-9414-84759b8983fc</paymentID>
    <userID>TeleIngresoPTUserMXN</userID>
    <paymentProvider>
      <key>153</key>
      <value>TelePay</value>
    </paymentProvider>
    <amount currencyCode="MXN">11.00</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>5197c9f3-6165-44e1-ad01-e229962598ab</id>
      <definition>
        <key>3</key>
        <value>InitiatedByProvider</value>
      </definition>
      <createdOn>2017-05-08T13:54:38.7797286Z</createdOn>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderResponseCode</key>
          <value>0</value>
        </detail>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderResponseMessage</key>
          <value>Accepted</value>
        </detail>
        <detail xsi:type="keyStringValuePair">
          <key>PaymentStateReasonID</key>
          <value>1</value>
        </detail>
      </paymentStateDetails>
    </state>
    <isExecuted>false</isExecuted>
    <baseAmount currencyCode="EUR">0.53</baseAmount>
    <paymentDetails>
      <detail xsi:type="keyDateTimeValuePair">
        <key>ExpirationDate</key>
        <value>2017-04-02T00:15:00</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>CertificateNumber</key>
        <value>428406800</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>BarCodeImageUrl</key>
        <value>https://www.datalogic.com.mx/PaynetCE/GetBarcodeImage.pn?text=00001O00042840680000001100230520172&amp;amp;bh=50&amp;amp;bw=1</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>PaynetCode</key>
        <value>00001O00042840680000001100230520172</value>
      </detail>
    </paymentDetails>
    <paymentAccount>
      <paymentAccountID>0</paymentAccountID>
    </paymentAccount>
  </payment>
</initiatePaymentResponse>

In the case of an error, the provider returns a return code being "1" (Declined) and one of the following error codes. In the rare case of a technical system error the return code "99" is returned.

Error Code

Description

200

Invalid Data

201

Non Applicable

202

Non Applicable

203

Certificate Type does not match

204

Certificate Value does not match

205

Certificate number does not match the merchant

206

Currency does not match

207

An error occured in the connection to the server

300

Invalid login and/or password

400

Certificate Date expired

Notifications

The provider notifies PXP Financial about successful payments, which go to state DepositedByProvider.

The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.

Notification sample for EUR:

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <payment xmlns="http://www.cqrpayments.com/PaymentProcessing" xsi:type="paymentWithPaymentAccount">
    <merchantID>B2BTestMerchant</merchantID>
    <shopID>TeleIngresoDepositEURShop</shopID>
    <paymentMethod>
      <key>237</key>
      <value>TeleIngresoDeposit</value>
    </paymentMethod>
    <merchantTransactionID>2e70d439-8ddf-4f74-baf7-7abda21cac35</merchantTransactionID>
    <paymentID>82c2de47-dff0-41da-bcd0-1bf8178147f5</paymentID>
    <userID>b39d3926-f9f3-4fba-82d9-cf2485</userID>
    <paymentProvider>
      <key>153</key>
      <value>TelePay</value>
    </paymentProvider>
    <amount currencyCode="EUR">10.0000</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>d46b81c6-ea63-45d7-893d-0a0b75771076</id>
      <definition>
        <key>29</key>
        <value>DepositedByProvider</value>
      </definition>
      <createdOn>2017-05-22T16:25:47.05</createdOn>
      <description />
      <paymentStateDetails xsi:nil="true" />
    </state>
    <isExecuted>true</isExecuted>
    <baseAmount currencyCode="EUR">10.0000</baseAmount>
    <paymentDetails>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderExternalID</key>
        <value>409</value>
      </detail>
      <detail xsi:type="keyDateTimeValuePair">
        <key>ExpirationDate</key>
        <value>2017-05-24T16:24:50</value>
      </detail>
      <detail xsi:type="keyDateTimeValuePair">
        <key>ProductionDate</key>
        <value>2017-05-22T00:00:00</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>CertificateNumber</key>
        <value>340362599</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderTransactionID</key>
        <value>340362599</value>
      </detail>
    </paymentDetails>
    <paymentAccount>
      <paymentAccountID>0</paymentAccountID>
    </paymentAccount>
  </payment>
</handlePaymentStateChangedNotificationRequest>

Notification sample for MXN:

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <payment xmlns="http://www.cqrpayments.com/PaymentProcessing" xsi:type="paymentWithPaymentAccount">
    <merchantID>B2BTestMerchant</merchantID>
    <shopID>TeleIngresoDepositEURShop</shopID>
    <paymentMethod>
      <key>237</key>
      <value>TeleIngresoDeposit</value>
    </paymentMethod>
    <merchantTransactionID>149b3fce-27b9-493e-a65c-1755fdb06fa8</merchantTransactionID>
    <paymentID>ec96e408-743b-4a79-abd7-f454533ab317</paymentID>
    <userID>a03c9264-6e1a-439e-92a5-1d2d5b</userID>
    <paymentProvider>
      <key>153</key>
      <value>TelePay</value>
    </paymentProvider>
    <amount currencyCode="MXN">10.0000</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>723c3397-eec5-4814-b556-a4d3107b8af3</id>
      <definition>
        <key>29</key>
        <value>DepositedByProvider</value>
      </definition>
      <createdOn>2017-05-22T16:43:03.503</createdOn>
      <description />
      <paymentStateDetails xsi:nil="true" />
    </state>
    <isExecuted>true</isExecuted>
    <baseAmount currencyCode="EUR">0.6900</baseAmount>
    <paymentDetails>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderExternalID</key>
        <value>410</value>
      </detail>
      <detail xsi:type="keyDateTimeValuePair">
        <key>ExpirationDate</key>
        <value>2018-05-22T16:42:38</value>
      </detail>
      <detail xsi:type="keyDateTimeValuePair">
        <key>ProductionDate</key>
        <value>2017-05-22T00:00:00</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>CertificateNumber</key>
        <value>340362599</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>BarCodeImageUrl</key>
        <value>https://www.datalogic.com.mx/PaynetCE/GetBarcodeImage.pn?text=00001O00034036259900000100160320179&amp;amp;bh=50&amp;amp;bw=1</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>PaynetCode</key>
        <value>00001O00034036259900000100160320179</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderTransactionID</key>
        <value>340362599</value>
      </detail>
    </paymentDetails>
    <paymentAccount>
      <paymentAccountID>0</paymentAccountID>
    </paymentAccount>
  </payment>
</handlePaymentStateChangedNotificationRequest>