Guía para integración de Pagos cuenta a cuenta con Floid(Perú)

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

{
    "amount" : 1000,
    "currency": "PEN",
    "consumer_id": 111111111,
    "webhook_url": "https://webhook.site/a23003ad-18ab-47f5-9777-56537f7756d8"
}

{
    "code": 200,
    "payment_token": "fc74b16d-9a07-4ee9-b1b4-3763bd23a4fd",
    "payment_url": "https://payments.floid.app/?id=fc74b16d-9a07-4ee9-b1b4-3763bd23a4fd"
}

{
	"payment_token": "xxx-xxx-xxx-xxx-xxx"
}

{
    "start_date": "2024-10-22 00:00:00",
    "end_date": "2024-10-22 23:59:59",
    "filter_by": "last_date"
}

{
  "code": 200,
  "status": "SUCCESS",
  "step": "FINISHED",
  "transfer_data": {
    "recipient_account": "054354357934790273094723",
    "recipient_id": "22222222222",
    "recipient_name": "Floid",
    "recipient_account_type": 1,
    "recipient_account_type_name": "corriente",
    "recipient_account_bank": 58,
    "recipient_account_bank_name": "banco_alfin_personas",
    "recipient_account_currency": "PEN",
    "amount": 1,
    "recipient_email": "[email protected]",
    "expected_amount": "1.00",
    "origin_id": "21231321321",
    "origin_account_bank": 806,
    "origin_account_bank_name": "CMAC Cusco",
    "origin_account": "435124123123123",
    "origin_account_type": 2,
    "origin_account_type_name": "ahorro",
    "date": "2013/05/2025 16:26:30"
  },
  "payment_id": "75f182a48f291142babd67651c14c2cf1",
  "message": "Transferencia realizada con éxito, validada por servicio Alfin",
  "payment_token": "f70e4dd8-4988-4c61-a002-05380cc1f5da",
  "amount": "1.00",
  "date": "2025-10-09T13:13:31.702Z",
  "iat": 1760022811
}

{
    "code": 200,
    "caseid": "d2e45c25-a884-48a5-b532-0aa0bc88d1c5",
    "msg": "OK",
    "data": [
        {
            "payment_token": "57b234c2-1cd4-4404-b609-d3d91fc11b4e",
            "status": "SUCCESS",
            "step": "FINISHED",
            "created_at": "2025-10-07 10:34:48",
            "last_date": "2025-10-07 10:35:29",
            "transfer_data": {
                "recipient_email": "[email protected]",
                "recipient_account": "50103506037",
                "recipient_id": "153150001",
                "recipient_name": "Cuenta 1",
                "recipient_account_type": 2,
                "recipient_account_type_name": "vista",
                "recipient_account_bank": 51,
                "recipient_account_bank_name": "Banco Falabella",
                "recipient_account_currency": "CLP",
                "amount": 1,
                "origin_id": "15.315.000-1",
                "origin_account_bank": 51,
                "origin_account_bank_name": "Banco Falabella",
                "origin_account": 50103506037,
                "origin_account_type": 2,
                "origin_account_type_name": "vista",
                "date": "2025-10-07 10:35:29"
            },
            "expired": false
        },
        {
            "payment_token": "4accc42d-8616-446e-a0b8-ce7b859e54ff",
            "status": "PENDING",
            "step": "SELECT_ACCOUNT",
            "created_at": "2025-10-07 10:38:04",
            "last_date": "2025-10-07 10:38:40",
            "transfer_data": {
                "recipient_email": "[email protected]",
                "recipient_account": "50103506037",
                "recipient_id": "153150001",
                "recipient_name": "Cuenta 1",
                "recipient_account_type": 2,
                "recipient_account_type_name": "vista",
                "recipient_account_bank": 51,
                "recipient_account_bank_name": "Banco Falabella",
                "recipient_account_currency": "CLP",
                "amount": 1,
                "origin_id": "15.315.000-1",
                "origin_account_bank": 51,
                "origin_account_bank_name": "Banco Falabella",
                "origin_account": 50103506037,
                "origin_account_type": 2,
                "origin_account_type_name": "vista"
            },
            "expired": false
        }
    ]
}

{
  "code": Int,
  "error_type": "string",
  "error_code": "string",
  "error_message": "string",
  "display_message": "string",
  "caseid": "string"
}

{
  "code": 400,
  "error_type": "PAYMENTS",
  "error_code": "INVALID_PAYMENT_TOKEN",
  "msg": "Token de pago inválido.",
  "error_message": "El token de pago no es válido",
  "display_message": "El token de pago no es válido",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{
  "code": 400,
  "error_type": "PAYMENTS",
  "error_code": "INVALID_PAYMENT_WIDGET",
  "msg": "Token de pago no tiene asociado un widget para el país y moneda.",
  "error_message": "El token de pago no tiene asociado un widget para el país y moneda.",
  "display_message": "El token de pago no tiene asociado un widget para el país y moneda.",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{
  "code": 400,
  "error_type": "PAYMENTS",
  "error_code": "INVALID_PAYMENT_ACCOUNT",
  "msg": "Token de pago no tiene asociada una cuenta recaudadora.",
  "error_message": "El token de pago no tiene asociada una cuenta recaudadora.",
  "display_message": "El token de pago no tiene asociada una cuenta recaudadora.",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{
  "code": 400,
  "error_type": "TRANSFER",
  "error_code": "INVALID_EXPIRATION_DATE",
  "error_message": "The specified expiration date does not have the proper format (YYYY-MM-DD hh:mm:ss) or is in the past.",
  "display_message": "La fecha de expiración especificada no cumple con el formato correcto (YYYY-MM-DD hh:mm:ss) o es anterior a la fecha actual.",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{
  "code": 400,
  "error_type": "API_ERROR",
  "error_code": "INVALID_REQUEST",
  "error_message": "The request is not valid. Check the body and headers and try again.",
  "display_message": "La request no es válida. Revisa el body y headers e intenta nuevamente. ' . $message . '",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{
  "code": 400,
  "error_type": "API_ERROR",
  "error_code": "INVALID_REQUEST_AMOUNT",
  "error_message": "The amount to be transferred must be different from 0",
  "display_message": "Monto a transferir debe ser distinto a 0",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{
  "code": 400,
  "error_type": "SERVICE_ERROR",
  "error_code": "SERVICE_UNAVAILABLE",
  "error_message": "The service is unavailable",
  "display_message": "The service is unavailable.",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{
  "code": 400,
  "error_type": "AUTH_ERROR",
  "error_code": "METHOD_NOT_AUTH",
  "error_message": "This method is not authorized",
  "display_message": "El metodo no está autorizado",
  "caseid":"xxx-xxx-xxx-xxx-xxx"
}

{    
    "amount": 3,
    "webhook_url": "https://wwww.mywebhook.in"
}

{
  "payment": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7Im5hbWUiOiJOT01CUkUgQ0xJRU5URSIsIm9wZXJhdGlvbl9udW1iZXIiOiIxNTgxMDQifSwiY29kZSI6MjAwLCJtZXNzYWdlIjoiVHJhbnNmZXJlbmNpYSByZWFsaXphZGEgY29uIGV4aXRvLiIsInRyYW5zZmVyX2RhdGEiOnsicmVjaXBpZW50X2VtYWlsIjoiY29ycmVvQGRlc3Rpbm8ucGUiLCJyZWNpcGllbnRfYWNjb3VudCI6IjUzMzAwMDU5MzY0IiwicmVjaXBpZW50X2lkIjoiMjIyMjIyMjIyIiwicmVjaXBpZW50X25hbWUiOiJFbXByZXNhIFNQQSIsInJlY2lwaWVudF9hY2NvdW50X3R5cGUiOjEsInJlY2lwaWVudF9hY2NvdW50X3R5cGVfbmFtZSI6ImNvcnJpZW50ZSIsInJlY2lwaWVudF9hY2NvdW50X2JhbmsiOjIsInJlY2lwaWVudF9hY2NvdW50X2JhbmtfbmFtZSI6IkJhbmNvIERlIENyw6lkaXRvIERlbCBQZXLDuiIsInJlY2lwaWVudF9hY2NvdW50X2N1cnJlbmN5IjoiQ0xQIiwiYW1vdW50Ijo1MDAwLCJvcmlnaW5faWQiOiIxMTExMTExMTEiLCJvcmlnaW5fYWNjb3VudF9iYW5rIjoyLCJvcmlnaW5fYWNjb3VudF9iYW5rX25hbWUiOiJCYW5jbyBEZSBDcsOpZGl0byBEZWwgUGVyw7oiLCJvcmlnaW5fYWNjb3VudCI6MTIzNDU2Nzg5MDEsIm9yaWdpbl9hY2NvdW50X3R5cGUiOjEsIm9yaWdpbl9hY2NvdW50X3R5cGVfbmFtZSI6ImNvcnJpZW50ZSIsImRhdGUiOiIyMDI1LTAxLTA3IDE3OjAzOjU2In0sInN0YXR1cyI6IlNVQ0NFU1MiLCJzdGVwIjoiRklOSVNIRUQiLCJwYXltZW50X2lkIjoiNGVjNDFhNjMzZGY5MTdkMTc2NzUxOWQ2YTc0ZTgwZWIyIiwicGF5bWVudF90b2tlbiI6IjBkMjczOTlmLTI0OWYtNGEyZS1iOTA0LTJlYjVjYzljYTkwMyIsImFtb3VudCI6IjUwMC4wMCIsImRhdGUiOiIyMDI1LTAxLTA3VDIwOjAzOjU3LjUwOVoiLCJjdXN0b20iOiJwYXJhbWV0cm9fY3VzdG9tIiwiaWF0IjoxNzM2MjgwMjM3fQ.qZ3UHhO2tktmT_-tXX6i5rB4QQjIcHnFxmDgRUW93oo"
}

{
  "data": 
    "operation_number": "158104"
  },
  "code": 200,
  "message": "Transferencia realizada con exito.",
  "transfer_data": {
    "recipient_email": "[email protected]",
    "recipient_account": "53300059364",
    "recipient_id": "222222222",
    "recipient_name": "Empresa SPA",
    "recipient_account_type": 1,
    "recipient_account_type_name": "corriente",
    "recipient_account_bank": 2,
    "recipient_account_bank_name": "Banco De Crédito Del Perú",
    "recipient_account_currency": "CLP",
    "amount": 5000,
    "origin_id": "111111111",
    "origin_account_bank": 2,
    "origin_account_bank_name": "Banco De Crédito Del Perú",
    "origin_account": 12345678901,
    "origin_account_type": 1,
    "origin_account_type_name": "corriente",
    "date": "2025-01-07 17:03:56"
  },
  "status": "SUCCESS",
  "step": "FINISHED",
  "payment_id": "4ec41a633df917d1767519d6a74e80eb2",
  "payment_token": "0d27399f-249f-4a2e-b904-2eb5cc9ca903",
  "amount": "500.00",
  "date": "2025-01-07T20:03:57.509Z",
  "custom": "parametro_custom",
  "iat": 1736280237
}