Body
SPEI
SPEI, founded by Banco de México, is a real-time money transfer service enabling Mexican customers to pay directly from their bank accounts via internet or mobile banking. It supports 24/7 transactions using a CLABE, debit card, or phone number, offering secure and seamless payments.
Request
Response
API Endpoints
Sandbox Link
POST
https://api.sandbox.juspay.io/txns
Production Link
POST
https://api.juspay.io/txns
Authorization Header
Basic Auth
*
Base64 Encoded username:password
required
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
x-merchantid
*
string
required
Merchant ID provided by Juspay
Example:-
merchant-id
version
string
Pass the date in YYYY-MM-DD format
Example:-
2023-01-01
Content-Type
String
application/x-www-form-urlencoded
Request Schema: application/json
Basic Parameters
order_id
*
string
required
Unique Identifier for the order. Should be Alphanumeric with character length less than 21.
Example:-
order-id-9876580
amount
*
Double
required
Amount that the customer has to pay. Will accept stringified double or integer values with upto two decimal places. For example, "100.15" and "100" are valid input but "100.1532" is not valid.
Example:-
1.00
options.get_client_auth_token
string
Client side authenticaion token required for Hyper SDK calls
Example:- Value : true
customer_id
string
It is the ID with which merchant refers to a customer object. This id is used to access the stored payment methods, allow EMI transactions and setup subscriptions.
In case of guest login it should be an empty string.
Example:-
customer-id-007
customer_email
string
Email address of the customer. If the backend gateway requires it, then you must send this value.
Example:-
test@gmail.com
customer_phone
string
Mobile number or fixed line number of the customer. If the backend gateway requires it, then you must send this value.
Example:-
99999999
currency
string
ISO string of the currency. Use MXN for Mexican Peso. Among other accepted values are BRL, EUR, USD, GBP, SGD, IDR etc. Default value: INR
description
string
Short description for the order. We send this information to the backend gateways whenever there is a provision for this.
return_url
string
A fully qualified URL which the customer will be redirected after payment completion. It is also required to provide the control back to SDK after the completion of transaction. This URL shouldn't contain any query parameters or Ip address. This URL takes higher precedence over the common return URL configured in your account settings.
Example:-
https://shop.merchant.com
product_id
string
An identifier for the product. Fits well for impulse purchase usecases.
Example:-
John
gateway_id
string
Specify your preferred gateway for this order.
Example:-
Wick
merchant_id
*
String
Mandatory
payment_method_type
*
String
Mandatory
This will be RTP for SPEI payments
redirect_after_payment
*
String
Mandatory
payment_method
*
String
Mandatory
The value for this field will be SPEI for SPEI payments
format
*
String
Mandatory
identity_credentials
Object
This field should be used to pass curp or rfc values in the json format.
sdk_params
*
Bool
Mandatory
This value should be passed if you are not doing SDK integration.
200 : Success
Response Body
status
*
string
Required
Status of order
Example:- NEW
order_id
*
string
Required
Order Id passed during order creation
txn_uuid
String
txn_id
*
String
Required
offer_details
Object
offers
Array of Strings
payment
*
Object
Required
authentication
*
Object
Required
method
*
String
Required
url
*
String
Required
400 : Invalid Input data
Response Body
status
string
Bad Request
error_code
string
Details of keys missing
Example:-
Mandatory fields are missing
error_message
string
Further Details of keys missing
Have questions?
- Need help? Contact support
- LLM? Read llms.txt