# /paymentmethods/bancontact/v1/transactions/{transactionId}/start

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Payments Gateway",
    "description": "Common payments API",
    "version": "1.23.0"
  },
  "security": [
    {
      "oAuth2ClientCredentials": []
    }
  ],
  "servers": [
    {
      "url": "/api/v1/"
    }
  ],
  "paths": {
    "/paymentmethods/bancontact/v1/transactions/{transactionId}/start": {
      "post": {
        "tags": [
          "bancontact"
        ],
        "operationId": "startBanContactTransaction",
        "parameters": [
          {
            "name": "transactionId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/Uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "type": "object",
                    "required": [
                      "browserInformation",
                      "encryptedCardDetails"
                    ],
                    "properties": {
                      "browserInformation": {
                        "type": "object",
                        "required": [
                          "shopperIp",
                          "accept",
                          "userAgent"
                        ],
                        "properties": {
                          "shopperIp": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 39,
                            "description": "IPv4 or IPv6 address for the consumer",
                            "example": "0.0.0.0"
                          },
                          "accept": {
                            "type": "string",
                            "description": "content-type accepted by the client browser",
                            "example": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
                          },
                          "userAgent": {
                            "type": "string",
                            "description": "User-Agent of the consumer' browser.",
                            "example": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36 Edge/18.18363"
                          }
                        }
                      },
                      "encryptedCardDetails": {
                        "type": "object",
                        "required": [
                          "data"
                        ],
                        "properties": {
                          "data": {
                            "type": "string",
                            "description": "The details that need to be encrypted are: [cardHolderName, cardNumber, expiryMonth, expiryYear, securityCode]\\n\nUse the library from '/paymentmethods/library/cse'. This contains a JS library with an exported function called 'cseEncrypt'.\n'let encrypted = cseEncrypt(cardHolderName, cardNumber, expiryMonth, expiryYear, securityCode);'\n"
                          }
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "headers": {
              "Digest": {
                "$ref": "#/components/headers/Digest"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "type": "object",
                      "required": [
                        "id",
                        "action"
                      ],
                      "properties": {
                        "id": {
                          "$ref": "#/components/schemas/Uuid"
                        },
                        "action": {
                          "type": "object",
                          "required": [
                            "redirect"
                          ],
                          "properties": {
                            "redirect": {
                              "type": "object",
                              "properties": {
                                "url": {
                                  "description": "URL where consumer should be redirected to by the merchant to perform the payment.",
                                  "type": "string",
                                  "format": "url",
                                  "example": "https://issuer.tld/ideal/start?trxid=213981209381209390821&random=wreq0dq90vgq0ew923123"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "4XX": {
            "$ref": "#/components/responses/UserError"
          },
          "5XX": {
            "$ref": "#/components/responses/InternalError"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Uuid": {
        "description": "Unique identifier",
        "type": "string",
        "format": "uuid",
        "minLength": 36,
        "maxLength": 36,
        "example": "8db1e7fa-ba8a-4189-92fd-67a20217443d"
      },
      "Digest": {
        "description": "Digest of whole message body",
        "type": "string",
        "example": "sha-256=OWM5MDc3ODYwNzdjYjE5NjU0Y2NjMDM4MzEyYzMxZTA5MTAzMDBjYWM1Y2I1ODM4NTdlMDU2MzhiMzE1ZDhjNw==",
        "externalDocs": {
          "description": "Instance Digests in HTTP",
          "url": "https://datatracker.ietf.org/doc/html/rfc3230"
        }
      }
    },
    "responses": {
      "InternalError": {
        "description": "Internal server error. This can be caused by an unresponsive backend",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "required": [
                "id",
                "message"
              ],
              "properties": {
                "id": {
                  "$ref": "#/components/schemas/Uuid"
                },
                "message": {
                  "type": "string",
                  "example": "Service Unavailable"
                }
              }
            }
          }
        }
      },
      "UserError": {
        "description": "The user input was incorrect or something illegal was attempted (eg. using a service without having that service configured for the user, or not being authorized)",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "required": [
                "id",
                "message"
              ],
              "properties": {
                "id": {
                  "$ref": "#/components/schemas/Uuid"
                },
                "message": {
                  "type": "string",
                  "example": "no authorization methods provided"
                }
              }
            }
          }
        }
      }
    },
    "headers": {
      "Digest": {
        "description": "Digest of whole message body",
        "schema": {
          "$ref": "#/components/schemas/Digest"
        }
      }
    },
    "securitySchemes": {
      "oAuth2ClientCredentials": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "/api/v1/authorization/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 103,
      "1": 234,
      "2": 76,
      "3": 191,
      "4": 145,
      "5": 198,
      "6": 48,
      "7": 79,
      "8": 46,
      "9": 249,
      "10": 185,
      "11": 249
    }
  }
}
```