Get payment status

Environments

Development

https://merchant.aplazo.net/api

Production

https://merchant.aplazo.mx/api

You can query the payment status either by loanId or cartId . You should only choose one.

Check loan or payment status

get

Retrieves the current status of a loan or payment using either loan_id or cart_id. You can only use one.

Authorizations

Query parameters

loan_idintegerOptional

The unique identifier of the loan to query the status.

cart_idstringRequired

The unique identifier of the cart/transaction on the merchant's ecommerce platform.

Responses

200

Loan or payment status retrieved successfully.

application/json

404

Cart not found.

get

HTTPcURLJavaScriptPython

GET /v1/loan/status?cart_id=text HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

{
  "loanId": 151187,
  "status": "ACTIVO"
}

Response Examples

Success

200 - Sucess - query with cart_id

curl --location 'https://merchant.aplazo.net/api/v1/loan/status?cart_id=some-cart' \
--header 'Authorization: Bearer <token here>'

Response

{
    "loanId": 159004,
    "status": "CANCELADO / DEVUELTO"
}

Errors

404 - CartId not found

curl --location 'https://merchant.aplazo.net/api/v1/loan/status?cart_id=some-cart' \
--header 'Authorization: Bearer <token here>'

Response

{
    "message": "loan by CartId = some-cart was not found.",
    "code": "LOAN_NOT_FOUND",
    "params": [
        "CartId",
        "some-cart"
    ],
    "payload": null
}

400 - Invalid query parameter

curl --location 'https://merchant.aplazo.net/api/v1/loan/status?cart_idx=3201' \
--header 'Authorization: Bearer <token here>'

{
    "message": "Card ID (cart_id) or Loan ID (loan_id) are required",
    "code": "LOAN_STATUS_NEED_CARTID_OR_LOANID",
    "params": null,
    "payload": null
}