StatusSupportGet API keys
Funding

Execute an order

POST/v1/teller/order

Executes an order previously created with POST /v1/teller/order/proforma, charging it with the payment method chosen there. A proforma can be executed only once and only while it is valid, so an expired one has to be created again.

When the user has to complete the payment, for example to pass 3-D Secure on a card or to approve a Bizum payment, the response comes with status: waiting-user and provider.requestConfiguration says how: open its uri when type is iframe, or wait for the user to approve it outside the app when type is external.

Authorization

ApiKeyAuth
X-Api-Key<token>

For accessing these endpoints a valid API key must be sent in the X-Api-Key header.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

Execute an order
curl --request POST \  --url 'https://gateway.bit2me.com/v1/teller/order' \  --header 'Content-Type: application/json' \  --data '{  "orderId": "dfcf2797-05f2-4cbb-ae5b-f5608dbbf6a9"}'
Example1 of 3
{  "orderId": "dfcf2797-05f2-4cbb-ae5b-f5608dbbf6a9",  "status": "accepted"}

Check if iban is valid POST

Checks whether an IBAN is well formed and its check digits are correct. It does not check that the account exists or who holds it. Send `iban` (required) and `countryCode` (optional) in the JSON body. This operation does not accept query parameters. An invalid IBAN is not an error: the response is `200` with `result: false`.

Cancel an order POST

Changes an order status from `waiting-user` to `cancelled`. Use this when the user decides not to proceed with a card payment that is awaiting confirmation.