Cómo acreditar al beneficiario

Acreditar el usuario destino

Una vez se confirma el débito de parte de la Entidad Originadora y la Entidad Receptora confirma la preparación del crédito, acreditar al usuario destino es el último paso en el procesamiento de la transferencia. Para realizar esta operación, ACH En Línea llama al endpoint v1/credits/{idCredit}/commit de la Entidad Receptora.

A continuación, se detallan las acciones involucradas, junto con ejemplos prácticos y consideraciones técnicas relevantes.

sequenceDiagram
    autonumber
    participant ach as ACH En Línea
    participant tb as Entidad Receptora

    ach ->> +tb: Llama al commit credit
    Note over ach,tb: /v1/credits/{idCredit}/commit
    tb ->> +tb: Realiza el crédito de fondos
    tb -->> -ach: 200 OK
    ach ->> ach: Finaliza la transacción

1. ACH En Línea llama al banco receptor para procesar la operación de commit del crédito

Para ejecutar la acreditación de recursos al beneficiario, ACH En Línea hace solicitud POST al endpoint v1/credits/{idCredit}/commit expuesto por la Entidad Receptora

Campos de entrada commit del crédito

Request commit del credito

curl --location 'https://url_participante/v1/credits/{idCredit}/commit' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}'

Data:

{
  "meta": {
    "id": "string",
    "status": "string"
  },
  "data": {
    "creditId": "string",
    "movementType": ["lista"],
    "amountInformation": {
      "amount": "decimal",
      "currency": ["lista"]
    },
    "source": {
      "personType": ["lista"],
      "document": {
        "number": "string",
        "type": ["lista"],
        "fullName": "string",
        "firstName": "string",
        "secondName": "string",
        "firstLastName": "string",
        "secondLastName": "string"
      },
      "spbviCode": ["lista"],
      "accountInformation": {
        "accountId": "string",
        "accountType": ["lista"],
        "financialInstitutionId": "entero"
      }
    },
    "target": {
      "personType": ["lista"],
      "document": {
        "number": "string",
        "type": ["lista"],
        "fullName": "string",
        "firstName": "string",
        "secondName": "string",
        "firstLastName": "string",
        "secondLastName": "string"
      },
      "targetSpbviCode": ["lista"],
      "alias": {
        "aliasType": ["lista"],
        "aliasValue": "string"
      },
      "accountInformation": {
        "accountId": "string",
        "accountType": ["lista"],
        "financialInstitutionId": "entero"
      },
      "qr": {
        "qrId": "string"
      }
    }
  }
}

2. Acreditación de fondos al beneficiario

La Entidad Receptora procesa la acreditación de fondos al beneficiario.

3. Confirmación del crédito

Una vez la Entidad Participante Receptora efectúa el proceso del crédito al usuario receptor. Envía la respuesta al llamado del commit del crédito.

HTTP/1.1 200 OK
Content-Length: 0

4. Finalización de la transacción

Una vez ACH Colombia recibe la confirmación del crédito (response del commit) por parte de la Entidad Receptora. El sistema ACH En Línea deja en firme el estado final de la transferencia.