1. Direct debit
API
English
  • Español
  • English
  • Introduction
    • Kambia API
    • Credentials
    • Authentication
    • Verification
      POST
  • Services
    • Code catalog
    • Payout
      • Notifications
      • Create payout
      • Get payout
    • Direct debit
      • How it works
      • Notifications
      • Affiliation
        POST
      • Charge
        POST
  1. Direct debit

Affiliation

Developing
POST
/{{api_version}}/autodebit/{{merchant_id}}/affiliation
Description
Enrolls customers in direct debit so they can be charged later.
Authentication
See the section here
Result per record
Each record comes back in details with its result: nueva (new), actualizada (updated), agregada (added), quitada (removed), rechazada (rejected, with the reason) or error (it couldn't be saved; send it again). reason explains when the account is saved without changing the charge account, or when you removed the charge account. If any record ended in error, the response is 207.
Several accounts per person
Optional account_action field on each record: replace (the account becomes the charge account), add (it is added without replacing the charge account; same as add_account: true) or remove (it is removed; if it was the charge account, the person is not charged until you choose another one). Without the field, a new account from the same bank replaces the charge account, as always. Up to 10 accounts per person. See How it works.

Request

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted
application/json
Bodyapplication/json

Response Response Example
{
    "status_code": 202,
    "message": "Affiliate record(s) processed successfully",
    "data": {
        "processed": 2,
        "rejected": 0,
        "total": 2,
        "details": [
            {
                "document_number": "12345678",
                "full_name": "Juan Perez",
                "outcome": "nueva"
            },
            {
                "document_number": "20123456789",
                "full_name": "Empresa SAC",
                "outcome": "nueva"
            }
        ]
    }
}
Modified at 2026-10-06 06:53:54
Previous
Notifications
Next
Charge
Built with