---
title: "Bizum"
method: POST
path: "/v1.02/bizum/create"
---

# Bizum

`POST /v1.02/bizum/create`

## Request

- Base URL: `https://sandbox.eupago.pt/api`
- URL: `https://sandbox.eupago.pt/api/v1.02/bizum/create`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/eupago/apis/rest-api-apikey-auth/docs/v1.02/bizum/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an url to a secure form where the customer may finish the Bizum payment. Supports 3D Secure Technology.

## Request body

- object
  - `payment` object, required: Informations regarding the payment
    - `identifier` string
    - `amount` object
      - `value` number, float, required: Payment amount
      - `currency` string, required
    - `successUrl` string, required: The payer will be forwarded to this url if the payment process is successful.
    - `failUrl` string, required: The payer will be forwarded to this url if the payment process fails (eg: no funds, problems with 3DS)
  - `customer` object: Informations regarding customer's notifications
    - `notify` boolean
    - `email` string: Customer's email

## Response `200`

200

- object
  - `transactionStatus` string
  - `transactionID` string
  - `reference` string
  - `redirectUrl` string

## Other responses

- `401`: 401

---

[API](https://skmtc.dev/eupago/apis/rest-api-apikey-auth.md) - [All operations](https://skmtc.dev/eupago/apis/rest-api-apikey-auth/llms.txt) - [OpenAPI document](https://skmtc.dev/eupago/apis/rest-api-apikey-auth/revisions/a8c2e94702a4?raw)