SPEI STP

Supported operations

SPEI STP integration in your payment strategy with DEUNA allows you to perform the following operations:

Purchase
Full refund

📘Make sure your account is properly configured on the SPEI STP side

Supported payment methods

APM: Bank Transfer

Active countries and currencies

Mexico (MXN)

Requirements

Contact your DEUNA representative and request the following credentials:

Your SPEI STP credentials

📘Make sure your account is properly configured on the SPEI OPM side.

Integrate SPEI STP

Integrate SPEI STP.

1. Look for SPEI STP in your connections

Search for SPEI STP in Connections.

In Connections, a window like the following will open:

2. Configure SPEI STP in your store

Enter the following credentials:
- In Name enter a name to reference the credential.
- In Currency select MXN.
- In Company enter your SPEI STP’s company name.
- In Bank Code enter the SPEI STP’s bank code.
- In Branch Code enter the SPEI STP’s branch code.
- In Client Prefix enter the SPEI STP’s client prefix.
- In Cost Center enter the SPEI STP’s cost center.
- In Expiration Time enter the SPEI STP’s expiration time in minutes.
- In Private Key enter the SPEI STP’s private key.
- Time do Expire - defines how long a transaction can remain unchanged before being marked as Expired.
Click Connect.

Once you complete the steps, you will see a success message.

3. Process transactions with SPEI STP

You will see the SPEI STP connection within the Active Connections tab.

From this point on, you can now process transactions with SPEI STP through DEUNA.

Purchase v2 Example

{
  "payer_info": {
    "email": "[email protected]"
  },
  "order_type": "DEUNA_NOW",
  "payment_source": {
    "method_type": "bank_transfer",
    "processor": "stp_spei"
  },
  "order": {
    "order_id": "99f4e588-42eb-41dc-a3ba-d10ccd4f6ae2",
    "currency": "MXN",
    "statement_descriptor": "test",
    "market_type": "ecommerce",
    "items": [
      {
        "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
        "name": "Item #1",
        "description": "Description Item #1",
        "total_amount": {
          "original_amount": 115000,
          "amount": 115000,
          "total_discount": 0,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 100000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "tax_amount": {
          "amount": 15000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "quantity": 1,
        "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
        "taxable": true
      },
      {
        "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
        "name": "Item #2",
        "description": "Description Item #2",
        "total_amount": {
          "original_amount": 115000,
          "amount": 115000,
          "total_discount": 0,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 100000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "tax_amount": {
          "amount": 15000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "quantity": 1,
        "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
        "taxable": true
      }
    ],
    "sub_total": 200000,
    "tax_amount": 30000,
    "total_tax_amount": 30000,
    "total_amount": 230000,
    "store_code": "all",
    "billing_address": {
      "id": "4255",
      "first_name": "Omar",
      "last_name": "Guzhnay",
      "email": "[email protected]",
      "address1": "Jose Luis Lagrange 123, Piso 12",
      "address2": "Polanco I Sección",
      "zipcode": "11510",
      "city": "MIGUEL HIDALGO",
      "state_code": "{{state_code}}",
      "state_name": "CIUDAD DE MÉXICO",
      "country_code": "MX",
      "identity_document": "1205973330",
      "identity_document_type": "",
      "phone": "+5930962917328",
      "lat": -22.943934,
      "lng": -43.182984,
      "additional_description": "confirm",
      "address_type": "home"
    }
  }
}

Purchase v1 example

{
  "payer_info": {
    "email": "[email protected]"
  },
  "order_type": "DEUNA_NOW",
  "payment_source": {
    "method_type": "bank_transfer",
    "processor": "stp_spei"
  },
  "order": {
    "order_id": "99f4e588-42eb-41dc-a3ba-d10ccd4f6ae2",
    "currency": "MXN",
    "statement_descriptor": "test",
    "market_type": "ecommerce",
    "items": [
      {
        "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
        "name": "Item #1",
        "description": "Description Item #1",
        "total_amount": {
          "original_amount": 115000,
          "amount": 115000,
          "total_discount": 0,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 100000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "tax_amount": {
          "amount": 15000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "quantity": 1,
        "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
        "taxable": true
      },
      {
        "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
        "name": "Item #2",
        "description": "Description Item #2",
        "total_amount": {
          "original_amount": 115000,
          "amount": 115000,
          "total_discount": 0,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 100000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "tax_amount": {
          "amount": 15000,
          "currency": "MXN",
          "currency_symbol": "$"
        },
        "quantity": 1,
        "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
        "taxable": true
      }
    ],
    "sub_total": 200000,
    "tax_amount": 30000,
    "total_tax_amount": 30000,
    "total_amount": 230000,
    "store_code": "all",
    "billing_address": {
      "id": "4255",
      "first_name": "Omar",
      "last_name": "Guzhnay",
      "email": "[email protected]",
      "address1": "Jose Luis Lagrange 123, Piso 12",
      "address2": "Polanco I Sección",
      "zipcode": "11510",
      "city": "MIGUEL HIDALGO",
      "state_code": "{{state_code}}",
      "state_name": "CIUDAD DE MÉXICO",
      "country_code": "MX",
      "identity_document": "1205973330",
      "identity_document_type": "",
      "phone": "+5930962917328",
      "lat": -22.943934,
      "lng": -43.182984,
      "additional_description": "confirm",
      "address_type": "home"
    }
  }
}

Special considerations and limitations

It’s only allowed the total refund
An order is EXPIRED when the time configured in the connection has concluded.