Simulate an incoming SEPA collection

POST /v2/sandbox/incoming_collections

This endpoint allows you to simulate an incoming SEPA collection to your account.

application/json

Body Required

  • amount integer(int64) Required

    Amount of the transfer, in cents. The currency is always EURO.

    Minimum value is 1.

  • local_iban string Required

    Existing IBAN to be used as the destination of the transfer. Can be the main IBAN of an account or a virtual IBAN.

    Format should match the following pattern: [A-Z]{2}[0-9]{2}[a-zA-Z0-9]{1,30}.

  • message string

    Message attached to this transfer, visible to all involved parties.

  • Unique identification to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. It can be used for reconciliation or to link tasks relating to the transaction.

    Minimum length is 1, maximum length is 35. Format should match the following pattern: [a-zA-Z0-9\-\?\:\(\)\.\,\'\+\ ]{1,35}.

  • mandate object

    The SEPA Direct Debit collection mandate. Allow you to provide mandate information that will be used for the transaction. If not provided, default values will be used.

    Additional properties are allowed.

    Hide mandate attributes Show mandate attributes object
    • The unique mandate reference.

      Format should match the following pattern: [A-Za-z0-9+?/\-:().,'\s]{1,35}.

    • creditor object

      The creditor associated with this mandate.

      Additional properties are allowed.

      Hide creditor attributes Show creditor attributes object
      • name string

        Name of the creditor.

        Minimum length is 1, maximum length is 256.

      • iban string

        IBAN of the creditor.

        Format should match the following pattern: [A-Z]{2}[0-9]{2}[a-zA-Z0-9]{1,30}.

      • SEPA identifier of the creditor.

        Format should match the following pattern: ([A-Z]{2})([0-9]{2})ZZZ([A-Z0-9]{4,}).

POST /v2/sandbox/incoming_collections
curl \
 -X POST https://api.sandbox.memo.bank/v2/sandbox/incoming_collections \
 -H "Content-Type: application/json" \
 -d '{"amount":500,"local_iban":"FR6430003000509825397888D64","message":"invoice no12345","end_to_end_id":"b0bfb42baa2642c2af0ca3e880fcd590","mandate":{"reference":"ABC123DEF","creditor":{"name":"John Doe","iban":"FR2512739000308553756377J95","sepa_identifier":"FR18ZZZ002305"}}}'
Request examples
{
  "amount": 500,
  "local_iban": "FR6430003000509825397888D64",
  "message": "invoice no12345",
  "end_to_end_id": "b0bfb42baa2642c2af0ca3e880fcd590",
  "mandate": {
    "reference": "ABC123DEF",
    "creditor": {
      "name": "John Doe",
      "iban": "FR2512739000308553756377J95",
      "sepa_identifier": "FR18ZZZ002305"
    }
  }
}