payout

Bitso delivers a payout event when a Colombia payout (CO_BREB or CO_ACH) changes status. payload matches Get payout.

Use the tabs to switch the example by payload.status.

{
  "event": "payout",
  "payload": {
    "id": "89325a16-669e-4118-a8f0-f4236db92503",
    "status": "PENDING",
    "amount": "50000",
    "asset": "COP",
    "type": "CO_BREB",
    "co_breb": {
      "key_type": "PHONE",
      "key_value": "3120000000",
      "beneficiary": {
        "document_type": "CC",
        "document_id": "12345678",
        "display_name": "JAN*** SMI***",
        "bank_name": "Bancolombia"
      }
    },
    "external_ref": "client-op-def456",
    "created_at": "2026-02-26T14:00:00Z"
  }
}

{
  "event": "payout",
  "payload": {
    "id": "89325a16-669e-4118-a8f0-f4236db92503",
    "status": "PROCESSING",
    "amount": "50000",
    "asset": "COP",
    "type": "CO_BREB",
    "co_breb": {
      "key_type": "PHONE",
      "key_value": "3120000000",
      "beneficiary": {
        "document_type": "CC",
        "document_id": "12345678",
        "display_name": "JAN*** SMI***",
        "bank_name": "Bancolombia"
      }
    },
    "external_ref": "client-op-def456",
    "created_at": "2026-02-26T14:00:00Z"
  }
}

{
  "event": "payout",
  "payload": {
    "id": "89325a16-669e-4118-a8f0-f4236db92503",
    "status": "COMPLETED",
    "amount": "50000",
    "asset": "COP",
    "type": "CO_BREB",
    "co_breb": {
      "key_type": "PHONE",
      "key_value": "3120000000",
      "beneficiary": {
        "document_type": "CC",
        "document_id": "12345678",
        "display_name": "JAN*** SMI***",
        "bank_name": "Bancolombia"
      }
    },
    "external_ref": "client-op-def456",
    "created_at": "2026-02-26T14:00:00Z",
    "updated_at": "2026-02-26T14:08:00Z"
  }
}

{
  "event": "payout",
  "payload": {
    "id": "89325a16-669e-4118-a8f0-f4236db92503",
    "status": "FAILED",
    "amount": "50000",
    "asset": "COP",
    "type": "CO_BREB",
    "co_breb": {
      "key_type": "PHONE",
      "key_value": "3120000000",
      "beneficiary": {
        "document_type": "CC",
        "document_id": "12345678",
        "display_name": "JAN*** SMI***",
        "bank_name": "Bancolombia"
      }
    },
    "external_ref": "client-op-def456",
    "created_at": "2026-02-26T14:00:00Z",
    "updated_at": "2026-02-26T14:08:00Z"
  }
}