Transferencia de datos de pago
Introducción
Descripción general técnica
Manual
Ejemplos de código


Descripción general técnica


La transferencia de datos de pago (PDT) proporciona a los vendedores la capacidad de mostrar detalles de transacción a compradores a los que se envía de vuelta a su sitio Web después de completar el pago.

Cómo funciona

Una vez activada la PDT, cada vez que un comprador realice un pago en el sitio Web, y se le envíe a su URL de retorno, se pasará un código personal de transacción como variable "GET" a esta URL de retorno. Para usar correctamente la PDT y mostrar detalles de transacción a su cliente, debería recuperar el código personal de transacción, con el nombre de variable "tx", y recuperar los detalles de la transacción de PayPal creando un HTTP POST a PayPal.

El POST se debe enviar a https://www.paypal.com/cgi-bin/webscr. Debe enviar el código personal de la transacción usando la variable "tx" y el valor del código de transacción recibido previamente (por ejemplo, "tx=transaction_token"), y el código de transacción especial de identidad usando la variable at y el valor de su código personal de identidad PDT (por ejemplo, "at=identity_token"). También deberá añadir una variable llamada "cmd" con el valor "_notify-synch", por ejemplo "cmd=_notify-synch", a la cadena POST.

PayPal responderá al envío con una sola palabra, ÉXITO o FRACASO, en una línea en el cuerpo de la respuesta. Cuando reciba una respuesta ÉXITO, el resto del cuerpo de la respuesta serán los detalles de la transacción, uno por línea, en el formato key=value, donde tanto key como value serán cadenas de URL codificadas. Estos datos de respuesta se deben analizar adecuadamente y a continuación decodificarse en el sitio Web.

Ejemplo de respuesta de éxito:
ÉXITO
first_name=Jane+Doe
last_name=Smith
payment_status=Completado
payer_email=janiedoesmith@hotmail.com
payment_gross=3.99
mc_currency=USD
custom=For+the+purchase+of+the+rare+book+Green+Eggs+%26+Ham
...

Puede mostrar a su cliente cualesquiera detalles de pago que considere apropiados; sin embargo, PayPal recomienda incluir la dirección de envío, el correo electrónico del pagador y el importe pagado. Si usa PDT para determinar cuándo atender automáticamente un pedido, confirme que el payment_status es Completado, ya que el comprador podría usar métodos tales como echecks, que no se hacen efectivos al instante.

Si usa estos datos para atender pedidos, PayPal le recomienda encarecidamente que active la IPN para estar al tanto de cuándo se hacen efectivos. Para obtener más información, consulte el manual de IPN de PayPal, disponible en el sitio Web.

Si la respuesta es FRACASO, puede intentar volver a enviar a PayPal para determinar si ha sido un error de red que ha provocado un fallo; sin embargo, si el segundo intento falla también, PayPal le recomienda revisar su secuencia de comandos y seguir investigando:
  • Asegúrese de que "txn_id" no es un duplicado para impedir que alguien utilice una antigua transacción completada.
  • Valide que receiver_email es una dirección de correo electrónico registrada en su cuenta PayPal, con el fin de impedir que el pago se envíe a la cuenta de una persona con intenciones fraudulentas.
  • Compruebe otros detalles de la transacción como el número de artículo y el precio para confirmar que el precio no ha cambiado.

Variables de IPN

Para obtener una lista completa de las variables IPN e instrucciones detalladas sobre cómo usar la notificación de pago instantánea, consulte el Guía de integración para Pagos en sitio web

Para leer los manuales de PayPal, se requiere Adobe Acrobat.