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>