WhatsApp Flows (Kit T2)

Endpoint data-exchange del Flow de cobro

Punto de data-exchange de WhatsApp Flows (esquema oficial de Meta). Tu Flow apunta aquí en vez de llamar directo al banco. El cuerpo es el sobre cifrado de Meta (encrypted_flow_data / encrypted_aes_key / initial_vector en base64; RSA-OAEP + AES-128-GCM, IV invertido) y la respuesta es texto plano base64(cipher+tag) cifrada con la misma AES key. REQUEST_TOKEN pide el OTP, CONFIRM_PAYMENT cobra. El tenant/cobrador salen del binding (flowId + flow_secret en el flow_token o header x-flow-secret), nunca del payload. No usa x-switch-key.

post/switch/v1/flows/cobro/{flowId}

Request

  • Base URL: https://pay.pagaconquickpay.com
  • URL: https://pay.pagaconquickpay.com/switch/v1/flows/cobro/{flowId}
  • Auth: none required

Path parameters

flowIdstring uuid required

Id del binding comercio↔flow (lo devuelve el alta del binding).

Headers

x-flow-secretstring

Alternativa a poner el flow_secret como prefijo del flow_token. Se compara en tiempo constante.

Request body

encrypted_flow_datastring required

AES-128-GCM(flow_data) + tag, en base64.

encrypted_aes_keystring required

AES key efímera envuelta con RSA-OAEP(SHA-256), en base64.

initial_vectorstring required

IV de 16 bytes en base64 (la respuesta usa su versión invertida byte a byte).

Response

Respuesta cifrada de Meta (texto plano base64(cipher+tag))

Changes

No recorded changes to this operation across all 1 revision of this API.