Bank Transfers

Testing Functionality

Request Payload

{
    "clave": "1188439031",
    "fechaOperacion": "20240829",
    "institucionOrdenante": "40012",
    "institucionBeneficiaria": "90646",
    "claveRastreo": "MB12301002491231230123434890123123",
    "monto": "150",
    "tipoPago": "1",
    "tipoOperacion": "0",
    "nombreBeneficiario": "Alejandro de la Cruz                    ",
    "tipoCuentaBeneficiario": "40",
    "cuentaBeneficiario": "646010142603000036",
    "rfcCurpBeneficiario": "null",
    "conceptoPago": "Prueba",
    "referenciaNumerica": "2208240",
    "empresa": "ECARTPAY",
    "nombreOrdenante": "ROBERTO ALEJANDRO DE LA CRUZ MARTINEZ   ",
    "tipoCuentaOrdenante": "40",
    "cuentaOrdenante": "012930012422432535",
    "rfcCurpOrdenante": "CUMR880519HF4"
}

Endpoint

POST https://sandbox.ecartpay.com/webhooks/stp

Authorization Key

kGUoIbyplThmrLZblVWXYTfhFCIPYSWmc60xgBY7

Instructions

Setup: Ensure you have access to the Ecart Pay API environment, including the sandbox base URL and a valid authorization key.
Create a Test Order: Simulate a test order within your Ecart Pay sandbox environment. Ensure the order ID matches the sample data provided.

Initiate a Bank Transfer Test: Use the sample JSON data to trigger a bank transfer. Make sure to replace any dynamic fields, if required.

claveRastreo must always be unique for each transaction.
monto must match the amount being tested.

Image 2. Order Generated with the amount (monto).

cuentaBeneficiario must correspond to the beneficiary's account to which the money is being transferred.

Verify Response: After sending the POST request, check the response for confirmation of successful processing.

Error Handling: Test for potential errors, such as invalid CLABE or incorrect amounts. This helps ensure the robustness of the integration.
End-to-End Testing: Complete the testing cycle by verifying that the transferred amount is reflected in the Ecart Pay system and marked as paid for the corresponding order.

Example Request

To simulate the bank transfer, you can use the following cURL command:

curl --location -g --request POST '{{baseURL}}/webhooks/stp' \
--header 'Authorization: kGUoIbyplThmrLZblVWXYTfhFCIPYSWmc60xgBY7' \
--header 'Content-Type: application/json' \
--data '{
    "clave": "1188439031",
    "fechaOperacion": "20240829",
    "institucionOrdenante": "40012",
    "institucionBeneficiaria": "90646",
    "claveRastreo": "MB12301002491231230123434890123123",
    "monto": "150",
    "tipoPago": "1",
    "tipoOperacion": "0",
    "nombreBeneficiario": "Alejandro de la Cruz                    ",
    "tipoCuentaBeneficiario": "40",
    "cuentaBeneficiario": "646010142603000036",
    "rfcCurpBeneficiario": "null",
    "conceptoPago": "Prueba",
    "referenciaNumerica": "2208240",
    "empresa": "ECARTPAY",
    "nombreOrdenante": "ROBERTO ALEJANDRO DE LA CRUZ MARTINEZ   ",
    "tipoCuentaOrdenante": "40",
    "cuentaOrdenante": "012930012422432535",
    "rfcCurpOrdenante": "CUMR880519HF4"
}'

Example Response

Exito

By leveraging this testing data and endpoint, developers can ensure the smooth integration of bank transfers into their workflows, providing customers with a reliable and efficient payment method.

❗️
IMPORTANT
Make sure you have the Sandbox Environment enabled to perform the corresponding tests. If not, it will not work.