This page provides a guide for integrating CellPoint Velocity API with PSE ("pago seguro electrónico"), a bank transfer payment solution available for the Colombian peso currency (COP). PSE allows a customer to pay directly from their bank account without requiring a credit card.

Workflow

Initialize request - While loading the checkout page, the merchant's front-end application sends an Initialize request to the Velocity API.
Initialize response - The API returns an Initialize response containing PSE information, including a list of applicable banks.
Display options - The merchant application displays bank options and fields to collect payment information.
Collect payment information - The customer selects their bank, provides necessary information, and clicks the button to proceed.
Pay request - The merchant application sends a Pay request containing information for PSE.
Pay response - The API returns a Pay response containing URL redirect information.
Redirect to banking environment - The merchant application extracts the URL from the Pay response and redirects the customer to the PSE portal to authorize the payment.
Receive redirection - The merchant application receives the redirection and sends the customer to the merchant's confirmation page.
Get transaction status - The merchant application performs a Get Transaction Status API operation to confirm payment status.

Prerequisites

Work with your CellPoint Digital sales representative or account manager to sign up, set up your test account, and access your testing credentials.

Integration

Complete the following steps to use PSE with your integration.

1. Initialize payment

Endpoint: /mpoint/initialize-payment
Method: POST

Once the page has loaded, send a POST request to the /mpoint/initialize-payment endpoint of the CellPoint Velocity API. For more information, see our API integration guide and Initialize API reference.

Below is sample code of an Initialize request:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <initialize-payment account="101131" client-id="10101">
        <transaction order-no="TES442" type-id="1">
            <amount currency-id="170" country-id="405">29000000</amount>
            <hmac>d21ecb779a24763e3c99999999999999999e3ed619da965f025ed89fbdb621278476d1f8d7f7e0c203c95b474e3a30ebec2fd4972bd0c62230cba141e230286b</hmac>
            <orders/>
            <fees>
                <fee>2300</fee>
            </fees>
            <additional-data/>
        </transaction>
        <client-info language="en" sdk-version="2.0.0" version="2.0.0" platform="HTML5" profileid="">
            <mobile operator-id="40500" country-id="405">7676565454</mobile>
            <email>[email protected]</email>
            <customer-ref>[email protected]</customer-ref>
            <device-id>2E8667F78B23402BBFFFFFFFFFFF58D314566333</device-id>
            <ip>62.242.147.103</ip>
        </client-info>
    </initialize-payment>
</root>

If PSE is available according to the business rules defined by the merchant (in the Vision portal), then the API returns an Initialize response containing PSE information.

Note the following:

The returned PSE information is in aggregators, in a card element with name containing PSE.
The PSE card element contains an active-payment-methods array with a list of applicable banks.

See the relevant portion of a sample Initialize response below:

<aggregators>
    <card cvc-length="0" cvcmandatory="false" dcc="false" enabled="true" id="97" installment="0" max-length="0" min-length="0" payment-type="7" preferred="false" presentment-currency="false" processor-type="7" psp-id="-1" state-id="1" type-id="97">
        <name>PSE</name>
        <prefixes/>
        <active-payment-methods>
            <payment-method>
                <logoName>695f6a3c-e33e-4094-92bc-d142103d855a</logoName>
                <logoURL>0</logoURL>
                <displayName>A continuación seleccione su banco</displayName>
                <issuingBank>0</issuingBank>
                <displayOrder>1</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>ae1758d7-37a5-4c79-9925-d61e37046c3e</logoName>
                <logoURL>1815</logoURL>
                <displayName>ALIANZA FIDUCIARIA</displayName>
                <issuingBank>1815</issuingBank>
                <displayOrder>2</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>5895dfea-ef16-4b32-91c3-4f0696a13cff</logoName>
                <logoURL>1558</logoURL>
                <displayName>BAN100</displayName>
                <issuingBank>1558</issuingBank>
                <displayOrder>3</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>7452cb7b-e45c-47c4-960b-e8994cc4a387</logoName>
                <logoURL>15580</logoURL>
                <displayName>BAN100QA</displayName>
                <issuingBank>15580</issuingBank>
                <displayOrder>4</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>ed2dcc75-6f76-4c5c-bcf9-acb47e896f7b</logoName>
                <logoURL>1059</logoURL>
                <displayName>BANCAMIA</displayName>
                <issuingBank>1059</issuingBank>
                <displayOrder>5</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>55463aab-fab8-42fd-bb64-8ff7929a154b</logoName>
                <logoURL>1040</logoURL>
                <displayName>BANCO AGRARIO</displayName>
                <issuingBank>1040</issuingBank>
                <displayOrder>6</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>8a3dc860-cc9b-4c17-8a67-9f81b3ac22d3</logoName>
                <logoURL>1081</logoURL>
                <displayName>BANCO AGRARIO DESARROLLO</displayName>
                <issuingBank>1081</issuingBank>
                <displayOrder>7</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>5cb4b1cf-4b31-4e73-887c-8e93d22795c8</logoName>
                <logoURL>1080</logoURL>
                <displayName>BANCO AGRARIO QA DEFECTOS</displayName>
                <issuingBank>1080</issuingBank>
                <displayOrder>8</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>670737b2-aa99-4c0b-9362-e56d2b3d5966</logoName>
                <logoURL>1032</logoURL>
                <displayName>BANCO CAJA SOCIAL DESARROLLO</displayName>
                <issuingBank>1032</issuingBank>
                <displayOrder>9</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>d5035370-6b61-4c3c-9e24-ec2aa2b3c7c6</logoName>
                <logoURL>1052</logoURL>
                <displayName>BANCO COMERCIAL AVVILLAS S.A.</displayName>
                <issuingBank>1052</issuingBank>
                <displayOrder>10</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>b24caa5a-de52-4c1a-bdd5-63a9d0215bbd</logoName>
                <logoURL>1061</logoURL>
                <displayName>BANCO COOMEVA S.A. - BANCOOMEVA</displayName>
                <issuingBank>1061</issuingBank>
                <displayOrder>11</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>e9e0a0d4-7e02-4820-a0a4-45b8bdaab6af</logoName>
                <logoURL>1066</logoURL>
                <displayName>BANCO COOPERATIVO COOPCENTRAL</displayName>
                <issuingBank>1066</issuingBank>
                <displayOrder>12</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>7572e3da-8e67-4887-909e-15d3fd87491f</logoName>
                <logoURL>1051</logoURL>
                <displayName>BANCO DAVIVIENDA</displayName>
                <issuingBank>1051</issuingBank>
                <displayOrder>13</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>ffd74b9c-00ce-459f-a19e-2cc8b4f689b3</logoName>
                <logoURL>1001</logoURL>
                <displayName>BANCO DE BOGOTA DESARROLLO 2013</displayName>
                <issuingBank>1001</issuingBank>
                <displayOrder>14</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>e8562167-6bbf-47e0-9092-fd473b6d0dbb</logoName>
                <logoURL>1023</logoURL>
                <displayName>BANCO DE OCCIDENTE</displayName>
                <issuingBank>1023</issuingBank>
                <displayOrder>15</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>17fdf1c2-f635-4c66-b98e-5d86b674bf69</logoName>
                <logoURL>1062</logoURL>
                <displayName>BANCO FALABELLA</displayName>
                <issuingBank>1062</issuingBank>
                <displayOrder>16</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>a8608095-043c-49b7-bbf1-c1c140966092</logoName>
                <logoURL>1063</logoURL>
                <displayName>BANCO FINANDINA S.A BIC</displayName>
                <issuingBank>1063</issuingBank>
                <displayOrder>17</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>faafb24f-a9e1-4a7f-be8d-80ed8de70820</logoName>
                <logoURL>1012</logoURL>
                <displayName>BANCO GNB SUDAMERIS</displayName>
                <issuingBank>1012</issuingBank>
                <displayOrder>18</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>bac3b03d-b20e-47d8-a255-4afde8bf2fda</logoName>
                <logoURL>1071</logoURL>
                <displayName>BANCO J.P. MORGAN COLOMBIA S.A.</displayName>
                <issuingBank>1071</issuingBank>
                <displayOrder>19</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>109f4b9b-0c16-40e1-b83b-b5be9512f207</logoName>
                <logoURL>1047</logoURL>
                <displayName>BANCO MUNDO MUJER S.A.</displayName>
                <issuingBank>1047</issuingBank>
                <displayOrder>20</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>a108ddad-f78f-4622-b193-da8435c5d6a4</logoName>
                <logoURL>1060</logoURL>
                <displayName>BANCO PICHINCHA S.A.</displayName>
                <issuingBank>1060</issuingBank>
                <displayOrder>21</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>1e9e5b91-c929-40d2-aa5f-568817ae6f0c</logoName>
                <logoURL>1002</logoURL>
                <displayName>BANCO POPULAR</displayName>
                <issuingBank>1002</issuingBank>
                <displayOrder>22</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>5d8af107-85cf-4575-8f85-df13f50a60d1</logoName>
                <logoURL>1065</logoURL>
                <displayName>BANCO SANTANDER COLOMBIA</displayName>
                <issuingBank>1065</issuingBank>
                <displayOrder>23</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>a972736b-ca55-4a74-ab69-3f21a7ed293c</logoName>
                <logoURL>1069</logoURL>
                <displayName>BANCO SERFINANZA</displayName>
                <issuingBank>1069</issuingBank>
                <displayOrder>24</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>e941c225-f9b2-40ab-a488-e4c2aacf10dc</logoName>
                <logoURL>1303</logoURL>
                <displayName>BANCO UNION</displayName>
                <issuingBank>1303</issuingBank>
                <displayOrder>25</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>eed47a95-e3a4-4ab1-9fd6-2b7f6482df0c</logoName>
                <logoURL>1022</logoURL>
                <displayName>BANCO UNION COLOMBIANO</displayName>
                <issuingBank>1022</issuingBank>
                <displayOrder>26</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>00e1de3a-3364-4515-894e-33ef8508d401</logoName>
                <logoURL>1005</logoURL>
                <displayName>BANCO UNION COLOMBIANO FD2</displayName>
                <issuingBank>1005</issuingBank>
                <displayOrder>27</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>f1b5f3b2-20fc-47f4-842a-67f60712713e</logoName>
                <logoURL>1007</logoURL>
                <displayName>BANCOLOMBIA QA</displayName>
                <issuingBank>1007</issuingBank>
                <displayOrder>28</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>fef0d882-5950-4076-936f-eadb3fedce71</logoName>
                <logoURL>1077</logoURL>
                <displayName>BANKA</displayName>
                <issuingBank>1077</issuingBank>
                <displayOrder>29</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>4d794352-13be-447f-b4df-c3359e2a8180</logoName>
                <logoURL>1013</logoURL>
                <displayName>BBVA COLOMBIA S.A.</displayName>
                <issuingBank>1013</issuingBank>
                <displayOrder>30</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>48ae43fb-8c94-4fa3-8459-69270ebbefe4</logoName>
                <logoURL>1513</logoURL>
                <displayName>BBVA DESARROLLO</displayName>
                <issuingBank>1513</issuingBank>
                <displayOrder>31</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>16184bb9-c12d-44ac-9227-db5573bf0f1d</logoName>
                <logoURL>1808</logoURL>
                <displayName>BOLD CF</displayName>
                <issuingBank>1808</issuingBank>
                <displayOrder>32</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>f727c0ca-417c-4e63-b89b-cf85c975c048</logoName>
                <logoURL>1009</logoURL>
                <displayName>CITIBANK COLOMBIA S.A.</displayName>
                <issuingBank>1009</issuingBank>
                <displayOrder>33</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>d2978aca-7319-4320-8c69-53c72d0f3515</logoName>
                <logoURL>1812</logoURL>
                <displayName>COINK SA</displayName>
                <issuingBank>1812</issuingBank>
                <displayOrder>34</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>f4788176-6bc5-4942-b083-48fdb6af3aca</logoName>
                <logoURL>1370</logoURL>
                <displayName>COLTEFINANCIERA</displayName>
                <issuingBank>1370</issuingBank>
                <displayOrder>35</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>2979f86b-a378-47ed-a228-81e68d96cd3e</logoName>
                <logoURL>1292</logoURL>
                <displayName>CONFIAR COOPERATIVA FINANCIERA</displayName>
                <issuingBank>1292</issuingBank>
                <displayOrder>36</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>1c0b3b3d-9819-4481-8e07-1fd0bfce8fd3</logoName>
                <logoURL>1291</logoURL>
                <displayName>COOFINEP COOPERATIVA FINANCIERA</displayName>
                <issuingBank>1291</issuingBank>
                <displayOrder>37</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>4ce5b34d-57c8-45ec-bb6e-e15912fda7a9</logoName>
                <logoURL>1289</logoURL>
                <displayName>COOPERATIVA FINANCIERA COTRAFA</displayName>
                <issuingBank>1289</issuingBank>
                <displayOrder>38</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>7396ec22-1017-4358-9abb-9a0ba5151d98</logoName>
                <logoURL>1283</logoURL>
                <displayName>COOPERATIVA FINANCIERA DE ANTIOQUIA CFA</displayName>
                <issuingBank>1283</issuingBank>
                <displayOrder>39</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>6727de17-bf4a-49f2-ad31-f0a09008ea52</logoName>
                <logoURL>1816</logoURL>
                <displayName>CREZCAMOS S.A. COMPAÑÍA DE FINANCIAMIENTO</displayName>
                <issuingBank>1816</issuingBank>
                <displayOrder>40</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>49ef3138-784e-4eae-ba25-2f98fb55e5cb</logoName>
                <logoURL>1097</logoURL>
                <displayName>DALE</displayName>
                <issuingBank>1097</issuingBank>
                <displayOrder>41</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>fc68941e-2162-4a8c-ae0e-96baaafc44c0</logoName>
                <logoURL>1551</logoURL>
                <displayName>DAVIPLATA</displayName>
                <issuingBank>1551</issuingBank>
                <displayOrder>42</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>49be8967-5752-4339-9e16-1875b780cfad</logoName>
                <logoURL>1802</logoURL>
                <displayName>DING TECNIPAGOS S.A.</displayName>
                <issuingBank>1802</issuingBank>
                <displayOrder>43</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>6d1be19f-eea8-4807-a351-ed01e1aefeaa</logoName>
                <logoURL>1121</logoURL>
                <displayName>FINANCIERA JURISCOOP S.A. COMPAÑIA DE FINANCIAMIENTO</displayName>
                <issuingBank>1121</issuingBank>
                <displayOrder>44</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>0d327922-b8d2-4df5-b7d6-9a1660d8d4f4</logoName>
                <logoURL>1814</logoURL>
                <displayName>GLOBAL 66</displayName>
                <issuingBank>1814</issuingBank>
                <displayOrder>45</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>df8800d8-6653-4fe3-84a3-0cdc88ab9207</logoName>
                <logoURL>1637</logoURL>
                <displayName>IRIS</displayName>
                <issuingBank>1637</issuingBank>
                <displayOrder>46</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>1a3a7e1e-41c0-4fbb-b3b6-c78429dbef2b</logoName>
                <logoURL>1006</logoURL>
                <displayName>ITAU</displayName>
                <issuingBank>1006</issuingBank>
                <displayOrder>47</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>1f36c27d-a96e-4547-aaf5-f63ab737fdba</logoName>
                <logoURL>1286</logoURL>
                <displayName>JFK COOPERATIVA FINANCIERA</displayName>
                <issuingBank>1286</issuingBank>
                <displayOrder>48</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>ac8c606a-ef24-406d-9b73-dae7b5490152</logoName>
                <logoURL>1070</logoURL>
                <displayName>LULO BANK</displayName>
                <issuingBank>1070</issuingBank>
                <displayOrder>49</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>70453eee-f63a-49ff-9613-51e2e28a3e8b</logoName>
                <logoURL>1801</logoURL>
                <displayName>MOVII S.A</displayName>
                <issuingBank>1801</issuingBank>
                <displayOrder>50</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>f753b391-c0b5-4d1b-b655-3219d0f2ac8d</logoName>
                <logoURL>1508</logoURL>
                <displayName>NEQUI CERTIFICACION</displayName>
                <issuingBank>1508</issuingBank>
                <displayOrder>51</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>437383b3-7b08-4267-b1b7-7b60174bce84</logoName>
                <logoURL>1809</logoURL>
                <displayName>NU</displayName>
                <issuingBank>1809</issuingBank>
                <displayOrder>52</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>a59e53a3-99d3-4f57-a543-e2eb0dbb8c36</logoName>
                <logoURL>1803</logoURL>
                <displayName>POWWI</displayName>
                <issuingBank>1803</issuingBank>
                <displayOrder>53</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>13257750-1bfb-4199-8931-e6584d3273ed</logoName>
                <logoURL>121212</logoURL>
                <displayName>Prueba Steve</displayName>
                <issuingBank>121212</issuingBank>
                <displayOrder>54</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>45750848-b2bb-487b-9c30-53dd41f3a0a2</logoName>
                <logoURL>1811</logoURL>
                <displayName>RAPPIPAY</displayName>
                <issuingBank>1811</issuingBank>
                <displayOrder>55</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>8a18f800-3bf3-4680-81d6-50a57e848f2c</logoName>
                <logoURL>1813</logoURL>
                <displayName>SANTANDER CONSUMER COLOMBIA</displayName>
                <issuingBank>1813</issuingBank>
                <displayOrder>56</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>d69cdab5-080a-4f8c-af42-9b04271e4fb1</logoName>
                <logoURL>1019</logoURL>
                <displayName>SCOTIABANK COLPATRIA DESARROLLO</displayName>
                <issuingBank>1019</issuingBank>
                <displayOrder>57</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>a35791b5-139b-4e31-91a1-08faa44c7c42</logoName>
                <logoURL>1078</logoURL>
                <displayName>SCOTIABANK COLPATRIA UAT</displayName>
                <issuingBank>1078</issuingBank>
                <displayOrder>58</displayOrder>
            </payment-method>
            <payment-method>
                <logoName>75b40700-7e21-47ed-a6c5-0f9b8db1a0a8</logoName>
                <logoURL>1804</logoURL>
                <displayName>Ualá</displayName>
                <issuingBank>1804</issuingBank>
                <displayOrder>59</displayOrder>
            </payment-method>
        </active-payment-methods>PSE</card>
</aggregators>

For a full sample response and parameter definitions, see Initialize in our API Reference.

2. Capture payment information

Extract the display names from the Initialize response's list of applicable banks. Display them to the customer so they can select the bank they wish to use for PSE. CellPoint Digital recommends displaying these options in a drop-down menu.

Additionally, provide fields for the customer to enter their payment information, including the following mandatory fields for PSE:

first name
last name
street address
city
identification document type
identification document number

For a list of acceptable identification document types, see additional-data: tax_id_type in Pay API Request Parameters.

3. Send Pay request

Endpoint: /mpoint/pay
Method: POST

Send a POST request to the /mpoint/pay endpoint of the CellPoint Velocity API. For more information, see our API integration guide and Pay API reference. The request should include the following:

The information the customer provided (in step 2), in the appropriate fields in the request.
The bank code associated with the bank the customer selected. This is found in the Initialize response (in step 1) in the issuingBank element associated with the selected bank. Include it in the Pay request as the value of transaction: card: token.

See the following example of a Pay request using bank code 1022:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <pay account="101133" client-id="10101">
        <transaction id="80777777" store-card="false">
            <card type-id="97">
                <amount country-id="405" currency-id="170">31500000</amount>
                <token>1022</token>
            </card>
            <additional-data>
                <param name="tax id _ _ type">NIT</param>
                <param name="tax _ id">1015076001</param>
            </additional-data>
            <billing-address country-id="405">
                <first-name>First</first-name>
                <last-name>Last</last-name>
                <street>Calle 123</street>
                <postal-code>054040</postal-code>
                <city>Rionegro</city>
                <state>Colombia</state>
                <contact-details>
                    <mobile country-id="405" operator-id="10000">3053333338</mobile>
                    <email>[email protected]</email>
                </contact-details>
            </billing-address>
            <hmac>9fbc61fa6b97413a381166e27e0c8b98d90959269b0c8b98d90959269bccaa38d
091003107987a9e7c84c94e4f34b856537f6ac4672a29d4d5429fbc61fa6b97</hmac>
        </transaction>
        <client-info language="en" platform="HTML5" profileid="" sdk-version="2.0.0" version="2.0.0">
            <mobile country-id="405" operator-id="40500">7673333338</mobile>
            <email>[email protected]</email>
            <ip>62.111.111.111</ip>
        </client-info>
    </pay>
</root>

For parameter definitions, see Pay in our API Reference.

4. Redirect customer to PSE portal

The API returns a Pay response containing URL redirect information. Extract this information to redirect the customer. Your method depends on the provider used:

SafetyPay - If using SafetyPay, the Pay response contains the full redirect URL in the text content of url.
PayU - If using PayU, create the URL from the Pay response's url and enc. Do this by appending the text contents of enc to the text contents of url as follows: {url-value}?enc={enc-value}.

See the examples below.

SafetyPay example

Below is a SafetyPay sample response. Here, the redirect URL is https://av.uat-01.cellpointmobile.net/mpoint/aggregator/safetypay/redirect:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <psp-info id="70" merchant-account="SafetyPay-Colombia" type="4">
        <url content-type="application/x-www-form-urlencoded" method="POST">https://sandbox-gateway.safetypay.com/banksgateway/9289/432457</url>
        <hidden-fields/>
        <accept-url>https://av.uat-01.cellpointmobile.net/mpoint/aggregator/safetypay/redirect</accept-url>
        <name>card_holderName</name>
        <auth-token>Auth-Token</auth-token>
        <message language="en"/>
    </psp-info>
    <status code="1041">Payment Pending</status>
</root>

PayU example

Below is a PayU sample response. Here, the redirect URL is https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=W5k3oFewEk3p3X6iOiUXURK0hSnjcLFh9AQh1BrmXiw%3d:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <psp-info id="53" merchant-account="99881bc0-b634-4f68-b061-c447b5d49dee" type="7">
        <url content-type="application/x-www-form-urlencoded" method="GET" type-id="11">https://registro.desarrollo.pse.com.co/PSENF/index.html</url>
        <hidden-fields>
            <enc>W5k3oFewEk3p3X6iOiUXURK0hSnjcLFh9AQh1BrmXiw%3d</enc>
        </hidden-fields>
        <accept-url>https://av.uat-01.cellpointmobile.net/mpoint/aggregator/payu/redirect</accept-url>
        <name>card_holderName</name>
        <auth-token>Auth-Token</auth-token>
        <message language="en"/>
    </psp-info>
    <status code="1041">Payment Pending</status>
</root>

For parameter definitions and more information about the Pay response, see Pay in our API Reference.

Use the extracted URL to redirect the customer to their PSE provider, where they can complete their payment.

5. Redirect customer to confirmation page

When the customer has completed the prompts for the PSE provider, you receive a redirect and may send the customer to the appropriate confirmation page; however, the transaction is not complete until the provider sends confirmation, which can take 3 to 20 minutes. Work with your CellPoint Digital representative to determine the best redirect handling procedure for your integration.

6. Get transaction status

Endpoint: /mpoint/get-transaction-status
Method: GET

To confirm payment status, send a GET request for this transaction to the /mpoint/get-transaction-status of the CellPoint Velocity API. For more information on this operation, see Get Transaction Status in our API reference.