SPEI

Onde enviar um pagamento pela SPEI no México.

Criar um payout pela SPEI no México

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

Este endpoint permite que você submeta um Payout por SPEI no México.

Headers

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

Request Body

Name	Type	Description
name*	string	Nome do beneficiário - entre 5 e 100 chars -
phone	string	Telefone do beneficiário
email	string	E-mail do beneficiário
bank_code*	number	código do banco, ver lista de bancos
account*	number	conta, o comprimento é 18
account_type*	string	um dos [debit | phone | clabe]
document_id*	string	documento de identificação do beneficiário
document_type*	string	um dos [RFC | CURP | ND]
method*	string	método de payout, e.g. SPEI
custom_code*	string	merchant payout id
fee_bear*	string	um dos [beneficiary | merchant]
amount*	number	Valor do Payout, 2 números decimais - Min 0.01, Max 50,000 -
source_currency*	string	Moeda da conta do Merchant USD, EUR, GBP, MXN
arrival_currency*	string	MXN para Mexico
notify_url*	string	Onde a pagsmile vai enviar o callback
additional_remark*	string	Observação adicional - Max: 40 chars-
country*	string	MEX para Mexico

200: OK submit successfully.

{
    "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 order already existed.

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

401: Unauthorized unauthorized

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

500: Internal Server Error fee not configured

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

500: Internal Server Error balance insufficient

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

500: Internal Server Error system error

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

Exemplo

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
}'

Note: 94FAC**********************68548 is Pagsmile's test App ID for sandbox, and d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302 is authorization token associated with the test App ID.

No ambiente sandbox, favor usar 100000000000000000 como conta SPEI para testar o payout Falho(Failed), qualquer outra conta SPEI será bem sucedida.

Exemplo de conta SPEI

Tipo de conta	Conta	Texto
clabe	112233445566778899	18 dígitos
debit	1122334455667788	16 dígitos
phone	5522123456	10 dígitos

Tipo de documento no México

Os contribuintes mexicanos podem obter o RFC.

RFCs têm 13 dígitos para indivíduos, 12 para empresas, e são compostos de letras e números. Os primeiros 4 dígitos para pessoas físicas, ou 3 para empresas, são retirados do nome, depois há seis números que indicam a data de nascimento ou quando a empresa foi fundada, e os dígitos finais são dígitos de verificação.

O cidadão ou residente mexicano pode obter a CURP.

É um número de segurança social de 18 dígitos para as pessoas que vivem no México. Os 18 caracteres combinam informações derivadas de seu nome, data e local de nascimento, e sexo para criar um código único.