Initiate a payment

POST /v1/{payment-service}/{payment-product}

Path parameters

  • payment-service string Required

    Values are payments or bulk-payments.

  • payment-product string Required

    Values are sepa-credit-transfers or instant-sepa-credit-transfers.

Body object

One of:

Responses

  • default object

    default response

    • transactionStatus string Required

      Values are ACSC, RCVD, PDNG, RJCT, CANC, ACFC, or PART.

    • paymentId string Required
    • Minimum length is 0, maximum length is 500.

    • tppMessages array[object]
      • category string Required

        Values are ERROR or WARNING.

      • code string Required

        Values are ACCESS_EXCEEDED, BENEFICIARY_WHITELISTING_REQUIRED, CANCELLATION_INVALID, CERTIFICATE_BLOCKED, CERTIFICATE_EXPIRED, CERTIFICATE_INVALID, CERTIFICATE_MISSING, CERTIFICATE_REVOKE, CONSENT_EXPIRED, CONSENT_INVALID, CONSENT_UNKNOWN, CORPORATE_ID_INVALID, EXECUTION_DATE_INVALID, FORMAT_ERROR, FUNDS_NOT_AVAILABLE, KID_MISSING, PARAMETER_NOT_CONSISTENT, PARAMETER_NOT_SUPPORTED, PAYMENT_FAILED, PERIOD_INVALID, PRODUCT_INVALID, PRODUCT_UNKNOWN, PSU_CREDENTIALS_INVALID, REQUESTED_FORMATS_INVALID, RESOURCE_BLOCKED, RESOURCE_EXPIRED, RESOURCE_UNKNOWN, ROLE_INVALID, SCA_INVALID, SCA_METHOD_UNKNOWN, SERVICE_BLOCKED, SERVICE_INVALID, SESSIONS_NOT_SUPPORTED, SIGNATURE_INVALID, SIGNATURE_MISSING, STATUS_INVALID, TIMESTAMP_INVALID, TOKEN_EXPIRED, TOKEN_INVALID, TOKEN_UNKNOWN, or WARNING.

      • path string
      • text string

        Minimum length is 0, maximum length is 500.

POST /v1/{payment-service}/{payment-product}
curl \
 -X POST https://api.memo.bank/nextgenpsd2/v1/{payment-service}/{payment-product} \
 -H "Content-Type: application/json" \
 -H "Signature: $SIGNATURE" \
 -d '{"debtorAccount":{"iban":"string","currency":"string","cashAccountType":"string"},"instructedAmount":{"currency":"string","amount":"string"},"creditorAccount":{"iban":"string","currency":"string","cashAccountType":"string"},"creditorName":"string","endToEndIdentification":"string","remittanceInformationUnstructured":"string","requestedExecutionDate":"2023-05-04"}'
Request examples
# Headers
Signature: $SIGNATURE

# Payload
{
  "debtorAccount": {
    "iban": "string",
    "currency": "string",
    "cashAccountType": "string"
  },
  "instructedAmount": {
    "currency": "string",
    "amount": "string"
  },
  "creditorAccount": {
    "iban": "string",
    "currency": "string",
    "cashAccountType": "string"
  },
  "creditorName": "string",
  "endToEndIdentification": "string",
  "remittanceInformationUnstructured": "string",
  "requestedExecutionDate": "2023-05-04"
}
# Headers
Signature: $SIGNATURE

# Payload
{
  "debtorAccount": {
    "iban": "string",
    "currency": "string",
    "cashAccountType": "string"
  },
  "payments": [
    {
      "instructedAmount": {
        "currency": "string",
        "amount": "string"
      },
      "creditorAccount": {
        "iban": "string",
        "currency": "string",
        "cashAccountType": "string"
      },
      "creditorName": "string",
      "endToEndIdentification": "string",
      "remittanceInformationUnstructured": "string"
    }
  ],
  "requestedExecutionDate": "2023-05-04"
}
Response example (default)
{
  "transactionStatus": "ACSC",
  "paymentId": "string",
  "_links": {
    "self": {
      "href": "string"
    },
    "status": {
      "href": "string"
    }
  },
  "psuMessage": "string",
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "ACCESS_EXCEEDED",
      "path": "string",
      "text": "string"
    }
  ]
}