SPEI

How to use SPEI to submit a payin in Mexico.

Item	Detail
Amount limit	1 - 50,000.00 MXN
Settlement	Real-time (instant after paid)
Refund	Supported

Post

https://gateway-test.luxtak.com/trade/pay

Payin by SPEI

This endpoint allows you to submit a payin by SPEI in Mexico.

Parameters

Parameter	Type	Description
Content-Type*	string	application/json; chartset=UTF-8
Authorization*	string	Basic Base($app_id:$security_key)

Body

Parameter	Type	Description
app_id*	string	created app's id at dashboard - Max. 32 chars -
timestamp*	string	yyyy-MM-dd HH:mm:ss - Max. 19 chars -
out_trade_no*	string	ID given by the merchant in their system - Max. 64 chars -
method*	string	Fixed value: SPEI
order_currency*	string	Fixed value: MXN
order_amount*	string	payment amount (1 - 50,000.00 MXN)
subject*	string	payment reason or item title - Max. 128 chars -
content	string	payment reason detail or item detail. - Max. 255 chars -
notify_url*	string	Where luxtak will send notification to
return_url	string	Redirect to Merchant's url when user finished checkout
trade_type	string	fixed value: API
buyer_id*	string	merchant user's id
timeout_express	string	m(minutes), h(hours), d(days), c(always end in current day). Used to control the expiration time of submitting an order (from initial to processing). (300mm in default, max 15d)

Responses


200	submit successfully

{
    "code": "10000",
    "msg": "Success",
    "prepay_id": "a2pKbVFV*****BD4eca",
    "trade_no": "2026****420",
    "out_trade_no": "out_trade_no_1464***166",
    "web_url": "",
    "pay_url": "https://checkout.luxtak.com/checkout?prepay_id=a2p***D4eca",
    "trade_status": "PROCESSING",
    "reference": "00***885",
    "clabe": "734****885",
    "bank_name": "FINCO PAY",
    "beneficiary_name": "VPAGO SOLUCOES DE PAGAMENTO",
    "due_date": "1780739699230"
}


400	duplicate out_trade_no

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "duplicate-out_trade_no",
    "sub_msg": "out_trade_no is duplicate"
}

Tips

User payment tips

Add a Copy CLABE button. The value of clabe is the only information that the user needs to use to complete payment. Adding a copy button could help to improve the user's payment experience.
Clabe will be unique for each order. Payment with incorrect clabe or incorrect amount will not be confirmed by the bank.
reference is the payment reference number; users may need it together with clabe when completing the transfer.

Note: 162********38 is luxtak's test app id for sandbox, and MTYyNTgyOTIxNDUzMTY2Mzg6UGFnc21pbGVfc2tfZDUwMWQ1ZGNkNTI5OGQ5N2MwNmUzYjI4YjA2OWZjZmY3NDU5ZjY2NzNiMjFjMTFlYTY3NDM5MDgzOTZkOTYxNQ== is authorization token associated with the test app id.

Warning

Please use your own app_id and generate your own authorization token when testing.