Payments

Ejecuta una acción de pago contra el procesador. Es el flujo de negocio principal del sistema.

Autenticación

Requiere X-Api-Key activa.

Entradas

Tipo de transacción: sale (por defecto) y, según configuración, operaciones relacionadas como auth, capture, refund, void o update.

Monto y moneda: importe positivo y código de moneda admitido.

Medio de pago: tarjeta (número, expiración, CVV) o equivalente; siempre procesado en servidor.

Datos de orden: identificadores de negocio (orden/cliente), descripción, metadatos.

Señales de seguridad (opcionales): atributos 3-D Secure / antifraude (cuando aplique).

Idempotencia (recomendado): clave única por intento de cobro/orden.

Salida

Estado de la acción (aprobada o no),

Códigos/textos de respuesta del procesador,

Identificadores (transacción, autorización),

Señales AVS/CVV para conciliación y riesgo,

Trazabilidad (Trace Id).

Validaciones clave

Monto > 0 y moneda soportada.

Datos del medio de pago con formato válido y sin caducidad.

Coherencia de parámetros de seguridad (si se envían señales 3DS, deben ser válidas).

Errores simulados

400 Bad Request: formatos inválidos, monto ≤ 0, expiración vencida, campos requeridos faltantes.

401 Unauthorized: API Key ausente/inválida o tenant/terminal inactivos.

402 Payment Required: rechazo emisor/procesador (fondos insuficientes, límites, sospecha de fraude).

422 Unprocessable Entity: inconsistencias en parámetros 3DS/antifraude.

429 Too Many Requests: límite por API Key excedido.

curl --location --request POST 'https://sandbox.mypaygateway.io/api/payments' \ --header 'X-Api-Key;' \ --header 'Content-Type: application/json' \ --data-raw '{ "type": "sunt id", "security_key": "non occaecat", "payment_token": "non dolore irure incididunt", "ccnumber": "51", "ccexp": "fugiat cillum dolor aliqua", "cvv": "292", "payment": "incididunt Excepteur esse id proident", "checkname": "Carles Mares Uribe", "checkaba": "dolore ea", "checkaccount": "est Ut consequat id do", "account_holder_type": "deserunt magna Lorem", "account_type": "eiusmod velit sunt culpa", "sec_code": "94", "googlepay_payment_data": "dolore anim velit", "amount": 690.45, "surcharge": null, "convenience_fee": -21492825.70800142, "misc_fee": -9382388.629812866, "misc_fee_name": "Lorena Almanza Espino", "cash_discount": -96453654.45702478, "tip": null, "currency": "ERN", "tax": null, "order_template": "quis enim cillum velit nostrud", "orderid": "1", "order_description": "Una delinquo labore. Antea voro studio deorsum.", "ipaddress": "e3cc:cc41:3acf:7dbf:33b3:fe9c:ab17:65aa", "first_name": "Carlos", "last_name": "Amador Osorio", "company": "sit commodo officia ad", "address1": "Calleja María, 4", "address2": "Puerta 110", "city": "El Ejido", "state": "Galicia", "zip": "e0e5:d8ee:bd25:18be:ab0e:9d0b:7419:2918", "country": "Australia", "email": "Emilio.ArenasLerma@gmail.com", "cardholder_auth": "Convertible", "three_ds_version": "ut mollit sed ipsum", "cavv": "aute", "xid": "81", "directory_server_id": "36", "transaction_session_id": "deposit", "source_transaction_id": "invoice", "merchant_defined_field_#": "commodo dolor laborum ea", "customer_receipt": null, "signature_image": "https://loremflickr.com/400/400?lock=2093298576983859" }'

{ "response": "string", "responsetext": "string", "authcode": "string", "transactionid": "string", "avsresponse": "string", "cvvresponse": "string", "orderid": "string", "response_code": "string", "emv_auth_response_data": "string", "customer_vault_id": "string", "kount_score": "string", "merchant_advice_code": "string" }

Autenticación

Entradas

Salida

Validaciones clave

Errores simulados

Solicitud

Respuestas

Payments

Autenticación#

Entradas#

Salida#

Validaciones clave#

Errores simulados#

Solicitud

Respuestas

Autenticación

Entradas

Salida

Validaciones clave

Errores simulados