SPEI

Dónde enviar un payout por SPEI en Mexico.

Enviar un payout por SPEI en Mexico

POST https://sandbox.transfersmile.com/api/payout

Este endpoint te permite usar SPEI para realizar un payout en Mexico.

Headers

Name	Type	Description
Content-Type*	string	application/json; charset=UTF-8
AppId*	string	APP ID en la plataforma de payout
Authorization*	string	SHA256($sorted_params + $app_key)

Request Body

Name	Type	Description
name*	string	Nombre de beneficiario, longitud entre 5 y 100
phone	string	Teléfono de beneficiario
email	string	Correo de beneficiario
bank_code*	number	Código de banco, ver bank list
account*	number	Longitud de cuenta es 18
account_type*	string	Uno entre [debit | phone | clabe]
document_id*	string	Número de identificación de beneficiario
document_type*	string	Uno entre [RFC | CURP | ND]
method*	string	Payout método, e.g. SPEI
custom_code*	string	Payout ID de merchant
fee_bear*	string	Uno entre [beneficiario | merchant]
amount*	number	Monto de Payout - Max. 2 números decimales - Min 0.01, Max 50,000 -
source_currency*	string	Moneda de cuenta de merchant Sólo uno: USD, EUR, GBP, MXN
arrival_currency*	string	MXN en Mexico
notify_url*	string	Donde Pagsmile enviará el callback
additional_remark*	string	Comentario adicional - Max Long: 40 -
country*	string	MEX por Mexico

200: OK Envío exitoso

{
    "code": 200,
    "msg": "success",
    "time": 1628580845,
    "data": {
        "id": "S202108100734054iRiUZFPXfQM",
        "custom_code": "custom_code9982674851738108",
        "arrival_amount": "0.51",
        "arrival_currency": "MXN",
        "source_amount": "0.07",
        "source_currency": "USD",
        "status": "IN_PROCESSING"
    }
}

400: Bad Request Orden ya existe

{
    "code": 4001010,
    "msg": "order already existed",
    "time": 1628580940,
    "data": {}
}

401: Unauthorized Desautorizado

{
    "code": 4004003,
    "msg": "permission denied",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

500: Internal Server Error Tarifa no configurada

{
    "code": 5001003,
    "msg": "fee not configured",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

500: Internal Server Error Balance insuficiente

{
    "code": 5001102,
    "msg": "balance insufficient",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

500: Internal Server Error Error de sistema

{
    "code": 5001000,
    "msg": "system error",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

Ejemplo

curl --location --request POST 'http://sandbox.transfersmile.com/api/payout' \
--header 'AppId: 94FAC**********************68548' \
--header 'Authorization: d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302' \
--header 'Content-Type: application/json' \
--data-raw '{
    * "name" : "GUILHERME ****** SOUZA",
      "phone" : "468****068",
      "email" : "g******[e-mail]",
    * "bank_code" : "90646",
    * "account" : "64618**********1800",
    * "account_type" : "clabe",
    * "document_id" : "CUP800****691",
    * "document_type" : "RFC",
    * "method" : "SPEI", // fixed value: SPEI
    * "custom_code" : "custom_code9982674851738108", // merchant order id
    * "fee_bear" : "merchant",
    * "amount" : "0.51",
    * "source_currency" : "USD",
    * "arrival_currency" : "MXN", // fixed value: MXN
    * "notify_url" : "https://notify.url",
    * "additional_remark" : "pagsmile payout test remark",
    * "country" : "MEX" // fixed value: MEX
}'

Nota: 94FAC**********************68548 es el test ID de pagsmile para prueba en sandbox, y d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302 es el token de autorización asociado con el app ID de prueba.

En ambiente sandbox, favor usar 100000000000000000 como cuenta SPEI para probar Failed payout, cuanlquier otra cuenta SPEI será exitoso.

Ejemplo de cuenta SPEI

Tipo cuenta	Cuenta	Texto
clabe	112233445566778899	18 dígitos
debit	1122334455667788	16 dígitos
phone	5522123456	10 dígitos

Tipo de documento en Mexico

Contribuyentes mexicanos pueden obtener RFC.

Los RFC tienen 13 dígitos para individuos, 12 para empresas, y están formados por letras y números. Los primeros 4 dígitos para individuos, o 3 para empresas, se toman del nombre, luego hay seis números que denotan la fecha de nacimiento o cuándo se fundó el negocio, y los dígitos finales son dígitos de control.

Ciudadano o residente mexicano podría obtener CURP.

Es un número de seguro social de 18 dígitos para las personas que viven en México. Los 18 caracteres combinan información derivada de su nombre, fecha y lugar de nacimiento, y género para crear un código único.