Bizum Server To Server Flow

Integration Guide

Pay Directly

Use the Pay Directly API to initiate a Bizum payment.

Request Body Parametersapplication/json

Response Body Parametersapplication/json

参数示例

Step2 Handle the Payment Response

When the payment is accepted, the pay directly API returns code: 002000 (Transaction processing). Key parameters in bizContent:

• action.paymentRedirectUrl: The Bizum payment confirmation page URL (when action.type is PAYMENT_REDIRECT_URL). After redirection, the consumer enters a mobile number registered and activated in the Bizum system, then authorizes the payment in their banking app with a password or biometric authentication. The session timeout is 30 minutes and the OTP operation time limit is 4 minutes; the payment must be re-initiated after a timeout.
• status: Transaction status. PROCESSING after acceptance; the final payment result is determined by the async notification.
• exchangedAmount / exchangedCurrency: The exchanged transaction amount and currency.
• transactionId: The PingPong transaction ID for reconciliation and inquiry.