Pagsmile ES
  • Introducción
  • Referencia
  • API Payin
    • Ambientes
    • Checkout "todo-en-uno"
      • Página Checkout (General)
      • Página Checkout (E-com)
    • Integración Directa
      • Brasil
        • Tarjeta de Crédito
        • Pix
        • Lottery
        • Boleto
        • Depósito Express
        • Wallet
      • México
        • SPEI
        • CoDi
        • OXXO
        • OXXOPay
        • Efectivo
        • Wallet
      • Colombia
        • PSE
        • Efecty
        • SuRed
        • Gana
        • Baloto
        • Wallet
      • Chile
        • Khipu
        • Transferencia Bancaria
        • Wallet
      • Perú
        • PagoEfectivo
        • Transferencia Bancaria
        • Efectivo
      • Ecuador
        • Transferencia Bancaria
        • Efectivo
      • Guatemala
        • Transferencia Bancaria
        • Efectivo
      • Costa Rica
        • Transferencia Bancaria
        • Efectivo
      • Panamá
        • Efectivo
      • El Salvador
        • Efectivo
      • Rusia
        • Wallet
      • Saudi Arabia
        • Tarjeta de Crédito
      • Kuwait
        • Tarjeta de Crédito
      • Qatar
        • Tarjeta de Crédito
      • Omán
        • Tarjeta de Crédito
      • Emiratos Árabes Unidos
        • Tarjeta de Crédito
      • Bahrain
        • Tarjeta de Crédito
    • Notificaciones
      • Security
    • Pagos Recurrentes
    • Detalle de Pago
    • Reembolso
    • Plug-in & Herramientas
      • Pagsmile JavaScript
      • Pagsmile SDK
      • Registro de lista de Bancos Disponibles
      • Verificación de Detalle de Cuotas
    • Data
      • Método de Pago
      • Data para pruebas (Sandbox)
      • Estado de Payin
      • Lista de Bancos
        • Bancos en Chile
        • Bancos en Peru
        • Bancos en Ecuador
        • Bancos en Panama
        • Bancos en Costa Rica
        • Bancos en El Salvador
        • Bancos en Guatemala
      • Logos de los métodos
    • Código API
  • Payout API
    • Ambientes
    • Seguridad
    • Enviar un payout
      • Pagsmile Wallet
        • Ejemplo WebView
        • Authorización H5
        • Autorización Nativa de APP
        • Enviar Bonificaciones
      • PayPal
        • Países Disponibles
      • Brasil
        • Pix
        • Transferencia Bancaria
      • Mexico
        • SPEI
      • Chile
        • Wallet
        • Transferencia Bancaria
      • Colombia
        • Wallet
        • Transferencia Bancaria
      • Peru
        • Transferencia Bancaria
        • Regiones en Peru
      • Ecuador
        • Transferencia Bancaria
    • Notificaciones
    • Simulación de Payout
    • Página Checkout
    • Balance de cuenta
    • Status de Payout
    • Lista de Payout
    • Detalle de Payout
    • Métodos de Pago
    • Data para pruebas
    • Códigos de Banco
      • Bancos en Brasil
      • Bancos en Chile
      • Bancos en Colombia
      • Bancos en Ecuador
      • Bancos en Mexico
      • Bancos en Peru
    • Código API
  • OTHER
    • Changelog
Powered by GitBook
On this page
  • Signature
  • Metodo de firma
  • Ejemplo de Sign Coding
  • Ejemplo de Signature
  1. Payout API

Seguridad

Cómo realizar requests de pagos seguros.

PreviousAmbientesNextEnviar un payout

Last updated 2 years ago

Signature

La signature debe usar SHA256 como función HMAC hash.

Encabezado

Tipo

Descripción

Content-Type

string

application/json; charset=UTF-8

AppId

string

Your App ID in payout platform

Authorization

string

SHA256($sorted_params + $app_key)

Encuentra $AppId, $app_key en el merchant dashboard.

Metodo de firma

  • Ascendentemente, params de solicitud ordenados, mira abajo;

  • Concatenar sorted_params con app_key.

  • Usar sha256(sorted_params + app_key) para obtener Autorización.

Al ordenar los parámetros, elimine los que no tienen valor.

Las letras en Authorization deben ser minúsculas.

Ejemplo de Sign Coding

package com.pagsmile.ts;

import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

import java.util.Map;
import java.util.TreeMap;

public static String getSign(Map<String, String> params, String authKey) {
    String param = sortParam(params) + authKey;
    return sha256(param);
}

public static String sha256(String str) {
    String encodeStr = "";
    try {
        MessageDigest digest = MessageDigest.getInstance("SHA-256");
        byte[] encodedhash = digest.digest(str.getBytes(StandardCharsets.UTF_8));
        encodeStr = bytesToHex(encodedhash);
    } catch (NoSuchAlgorithmException e) {
        throw new RuntimeException("algorithm not supported");
    }
    return encodeStr;
}

public static String sortParam(Map<String, String> params) {
    try {
        Map<String, String> map = new TreeMap<>(params);

        StringBuilder sb = new StringBuilder();
        for (String k : map.keySet()) {
            String v = map.get(k);
            if (v != null && v.length() > 0) {
                sb.append(k).append("=").append(v).append("&");
            }
        }

        if (sb.length() <= 0) {
            return "";
        }

        return sb.subSequence(0, sb.length() - 1).toString();
    } catch (Exception e) {
        e.printStackTrace();
    }
    return "";
}

private static String bytesToHex(byte[] hash) {
    StringBuilder hexString = new StringBuilder(2 * hash.length);
    for (int i = 0; i < hash.length; i++) {
        String hex = Integer.toHexString(0xff & hash[i]);
        if (hex.length() == 1) {
            hexString.append('0');
        }
        hexString.append(hex);
    }
    return hexString.toString();
}
<?php 
public function sign($params = array(),$merchantKey){

	ksort($params);
	
	$sign_string = '';
	
	foreach ($params as $key = > $value){
	
		if (!empty($value)){
			$sign_string.= $key.'='.$value.'&';
		}
	}
	
	$sign_string = substr($sign_string, 0, -1);
	
	$sign = hash("sha256", $sign_string.$merchantKey);
	
	return $sign;
}
?>
package crypto

import (
	"crypto/sha256"
	"encoding/hex"
	"fmt"
	"io"
	"sort"
	"strings"
)

// signature based sha256
func GetSign(m map[string]interface{}, merchantKey string) string {
	var w = sha256.New()
	_, _ = io.WriteString(w, sortedAndBuild(m) + merchantKey)
	return fmt.Sprintf("%x", w.Sum(nil))
}

func sortedAndBuild(m map[string]interface{}) string {
	var b strings.Builder
	l, c := len(m), 0
	keySet := make([]string, 0, l)
	for k, v := range m {
		keySet = append(keySet, k)
		if _, ok := v.(string); ok {
			c = len(k) + len(v.(string)) + 2
		} else {
			c = len(k) + 10 + 2
		}
	}

	b.Grow(c)
	sort.Strings(keySet)
	for _, k := range keySet {
		if v, ok := m[k]; ok {
			var str string
			if s, okk := v.(string); okk {
				str = s
			} else if d, okkk := v.(decimal.Decimal); okkk {
				str = d.String()
			} else {
				str = fmt.Sprintf("%v", v)
			}

			if len(str) > 0 {
				b.WriteString(k)
				b.WriteString("=")
				b.WriteString(str)
				b.WriteString("&")
			}
		}
	}
	r := strings.TrimRight(b.String(), "&")
	return r
}
# encoding: utf-8
import hashlib

# d is param dict
def ksort(d):
    return [(k,d[k]) for k in sorted(d.keys())]
    

# sha256
def sign(params,merchantKey):
    params = ksort(params)
    queryStr = ''
    for key, value in params:
        if value :
            queryStr += key + '=' + str(value) + '&'
    h2 = hashlib.sha256()
    h2.update((queryStr.rstrip('&') + merchantKey).encode(encoding='UTF-8', errors='strict'))

Ejemplo de Signature

Sample request:

{
	"account_digit": "4",
	"account_number": "1234567",
	"account_type": "CHECKING",
	"additional_remark": "1234567_test",
	"amount": "10.00",
	"bankcode": "001",
	"branch": "0001",
	"custom_code": "1234567",
	"document_id": "50284414727",
	"document_type": "CPF",
	"fee": "merchant",
	"name": "Test User Name",
	"notify_url": "https://www.pagsmile.com",
	"payout_currency": "BRL",
	"source_currency": "BRL"
}

Parámetros ordenados antes de hash:

account_digit=4&account_number=1234567&account_type=CHECKING&additional_remark=1234567_test&amount=10.00&bankcode=001&branch=0001&custom_code=1234567&document_id=50284414727&document_type=CPF&fee=merchant&name=Test User Name&notify_url=https://www.pagsmile.com&payout_currency=BRL&source_currency=BRL

Concatenar sorted_params con app_key (ejemplo app key ABCDE) :

account_digit=4&account_number=1234567&account_type=CHECKING&additional_remark=1234567_test&amount=10.00&bankcode=001&branch=0001&custom_code=1234567&document_id=50284414727&document_type=CPF&fee=merchant&name=Test User Name&notify_url=https://www.pagsmile.com&payout_currency=BRL&source_currency=BRLABCDE

sha256 hash

b15f900705867ecc3f66088054c14a80f9f12b1fb31c82320c4cbfe181876abb
examples