Saltar al contenido principal

Alipay y WeChat Pay

AliPay y WeChat Pay​

pcp alipaypcp wechatpay

Si necesita activar KakaoPay, consulta a tu contacto de Sipay.

Funciones​

  • Tipo: e-wallet
  • Canal:
    • Cobros por Internet
    • Cobros en Persona con QR en PIN Pad
    • Cobros en Persona con lector de QR externo
  • Operaciones:
    • Ventas
    • Devolución parcial
    • Devolución total

Integración​

nota

Recuerda que estas llamadas API serán peticiones HTTP POST a un la dirección TCP/IP donde está instalado el DeviceHub. Normalmente esta dirección será:

POST http://localhost:17000

Para realizar la integración necesitará una instalación válida de DeviceHub y un PIN Pad que soporte esta operativa. Las llamadas de DeviceHub que necesitará son:

  • InitializeDevice.
  • GetNextMessage.
  • CallSpecificFunction, consulte este vínculo para comprender los elementos comunes. Después acude a esta sección para integrar lo específico:
    • Función 70: generar QR en el PIN Pad para cobro con un Wallet específico.
    • Función 71: lectura de QR con un dispositivo externo y cobro.
    • Función 72: devolución.
    • Función 73: anulación de operación en curso.

Además deberás tener unas credenciales API e-commerce con los métodos de pago activados. Los datos que necesitan son:

  • key
  • resource
  • secret

La configuración del DeviceHub debe tener el siguiente contenido adicional antes del fin de sección </PROTOCOL_SETTINGS>:

devicehub.xml
...
</PUP_15_SETTNIGS>
<WECHATPAY_SETTINGS>
<WECHATPAY_BASE_URL>https://sandbox.sipay.es</WECHATPAY_BASE_URL>
<WECHATPAY_QR_URL>altp_starpay/api/v1/qr_generator</WECHATPAY_QR_URL>
<WECHATPAY_PAY_URL>altp_starpay/api/v1/barcode_pay</WECHATPAY_PAY_URL>
<WECHATPAY_REFUND_URL>altp_starpay/api/v1/refund_operation</WECHATPAY_REFUND_URL>
<WECHATPAY_STATUS_URL>altp_starpay/api/v1/operation_status</WECHATPAY_STATUS_URL>
<WECHATPAY_TIMEOUT>20</WECHATPAY_TIMEOUT>
</WECHATPAY_SETTINGS>
</PROTOCOL_SETTINGS>
...

Siendo la directiva <WECHATPAY_BASE_URL> el entorno entre estos valores:

  • https://sandbox.sipay.es para sandbox, pruebas e integración.
  • https://live.sipay.es para producción, transacciones reales.

Identificadores de wallet <WALLET></WALLET> disponibles:

  • wechatpay
  • alipay

Con estos valores generaremos la imagen QR correcta.

prototipo de petición
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tem="http://tempuri.org/">
    <soap:Header/>
    <soap:Body>
        <tem:CallSpecificFunctionRequest>
            <tem:Header>
                <tem:ClientId>ClientIdValue</tem:ClientId>
                <tem:StoreId>StoreIdValue</tem:StoreId>
                <tem:PosId>PosValue</tem:PosId>
                <tem:Lang>Idioma</tem:Lang>
                <tem:ExtraData1></tem:ExtraData1>
            </tem:Header>
            <tem:Function>70</tem:Function>
            <tem:Modifier>0</tem:Modifier>
            <tem:Parameter1>Importe</tem:Parameter1>
            <tem:Parameter2>Ticket</tem:Parameter2>
            <tem:Parameter3>
                <NONCE>nonce</NONCE>
                <RESOURCE>resource</RESOURCE>
                <KEY>key</KEY>
                <WALLET>identificador del wallet</WALLET>
                <ORDER_DESC>Descripción del pedido</ORDER_DESC>
                <STORE_NO></STORE_NO>
                <TERMINAL_NO></TERMINAL_NO>
                <EMPLOYEE_NO></EMPLOYEE_NO>
                <REMARK></REMARK>
            </tem:Parameter3>
        </tem:CallSpecificFunctionRequest>
    </soap:Body>
</soap:Envelope>