Mono Colombia
GuidesAPI reference

Finds the successful intent for an external_id

Returns the single intent in successful state whose external_id matches the given tenant-side identifier, answering "was this operation paid?" without storing Mono ids. At most one such intent exists per client.

GET
/v1/core/payins/intents/find_successful_by

Authorization

authorization
AuthorizationBearer <token>

In: header

Query Parameters

external_idstring

Tenant-side identifier of the intent.

Length1 <= length <= 255
Example"string"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.sandbox.cuentamono.com/v1/core/payins/intents/find_successful_by?external_id=string"
{
  "method_params": {
    "create_qr": false,
    "custom_key_value": "string",
    "qr_code_data": {
      "merchant_category_code": "5411",
      "receiver_city": "Bogota",
      "receiver_postal_code": "110111"
    },
    "required_tokens": [
      "qr"
    ]
  },
  "payment_tokens": {
    "key_type": "alphanumeric",
    "key_value": "@MN1A2B3C4D5E",
    "qr": {
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "emvco": "00020101021226440014CO.COM.CRB.RED0122CO.COM.CRB.TRXIDP123456752045411530317054061000005802CO5910Acme Store6006Bogota6304A1B2",
      "error_correction_level": "medium",
      "expires_at": "2022-01-01T01:00:00Z",
      "image": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAYAAAB...",
      "image_width": 512,
      "payment_id": "CO.COM.CRB.TRXIDP1234567891234",
      "usage_mode": "multiple_use"
    },
    "qr_error": null
  },
  "calculated_fees": {
    "payin": {
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "id": "fee_5tgliBmzjZ6mpQPRbQjfKj"
    },
    "payin_payer_spread": {
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "id": "fee_5tgliBmzjZ6mpQPRbQjfKj"
    },
    "payin_subaccount_spread": {
      "amount": {
        "amount": 100000000,
        "currency": "COP"
      },
      "id": "fee_5tgliBmzjZ6mpQPRbQjfKj"
    }
  },
  "custom_merchant_name": "string",
  "expected_payers": [
    {
      "document_number": "1023711432",
      "document_type": "CC",
      "kind": "co_person_document"
    }
  ],
  "expires_at": "2022-01-01T01:00:00Z",
  "external_id": "string",
  "id": "cpint_5tgliBmzjZ6mpQPRbQjfKj",
  "inserted_at": "2022-01-01T01:00:00Z",
  "merchant_amount": {
    "amount": 100000000,
    "currency": "COP"
  },
  "method": "co_breb",
  "payer_amount": {
    "amount": 100000000,
    "currency": "COP"
  },
  "payin_data": {
    "fee_override": [
      {
        "fixed": {
          "amount": 100000000,
          "currency": "COP"
        },
        "percentage": "0.05",
        "tx_description": "Collection service fee",
        "type": "payin"
      }
    ],
    "metadata": {
      "id": 3,
      "reference": 123
    },
    "redirect_url": "https://merchant.example.com/checkout/return",
    "subaccount_disbursement_trigger": "on_approval"
  },
  "prune_reason": null,
  "prune_state": "pruning",
  "pruned_at": "2022-01-01T01:00:00Z",
  "state": "created",
  "state_reason": "unknown",
  "subaccount_id": "lacc_5tgliBmzjZ6mpQPRbQjfKj",
  "template_id": "cpitpl_5tgliBmzjZ6mpQPRbQjfKj",
  "updated_at": "2022-01-01T01:00:00Z",
  "url": "https://www.mono.la/"
}
{
  "code": "401 Unauthorized",
  "errors": [
    {
      "error_code": "missing_authorization_header",
      "message": "`Authorization` header is missing.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Authorization header is missing or invalid."
}
{
  "code": "403 Forbidden",
  "errors": [
    {
      "error_code": "not_authorized",
      "message": "Not authorized to have access to this resource.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Not authorized to have access to this resource"
}
{
  "code": "404 Not Found",
  "errors": [
    {
      "error_code": "payin_intent_not_found",
      "message": "The payin intent doesn't exist.",
      "path": null,
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Resource not defined"
}
{
  "code": "422 Unprocessable Content",
  "errors": [
    {
      "error_code": "missing_field",
      "message": "The field is missing on the request body or parameters.",
      "path": "#/path/to/field",
      "url": null
    }
  ],
  "id": "log_7MkWaFqvfosB8fzHhb1Eql",
  "message": "Validation errors"
}