Versions Compared

Old Version 23

changes.mady.by.user Alejandro Martínez

Saved on

compared with

New Version 24

changes.mady.by.user Alejandro Martínez

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Permite tener la comunicación entre Spin y Fiserv para los módulos de customer.​

​Este componente se desarrolló para desacoplar los procesos core de Spin y el proveedor financiero para lograr una mayor escalabilidad.​

CreateCustomer

Descripción

Request

Response

HTTP Codes

Actualizar cliente

Descripción

Request

Response

HTTP Codes

Creación del cliente

Code Block
{
    "logo": "5060",
    "address": "CirueloCiruelas",
    "houseNumber": "12312345",
    "externalNumber": "10078007",
    "colony": "ResidencialLomas",
    "city": "VillaLomas de Alvarez",
    "state": "COL",
    "postalCode": "2898099980",
    "dateOfBirth": "19942000-0508-06",
    "stateOfBirth": "ColimaCDMX",
    "email": "lmedina@palo-it.com",
    "firstName": "Judith",
    "lastName": "Medina",
    "maternalLastName": "Ruiz",
    "mobilePhoneNumber": "31211635825521163588",
    "identificationNumber": "41525569874151136984152554487415113698",
    "ine": "1234117890099",
    "occupation": "Tester",
    "genderCode": "1",
    "user4":"1",
    "identificationNumberFlag": "2"
}

2 OK: Solicitud exitosa.

4 Bad Request: Request con campos no válidos.

5 Internal Server Error: Servicios no disponibles.

UpdateCustomer

 Code Block
{
    "
email
logo": "
lmedina@palo-it.com
60",
    "
numberType
address": 
1
"Ciruelas",
    "
customerNumber
houseNumber": "
0995000000000077863
12345",
    "
address
externalNumber": "
Ciruelo
8007",
    "
dateOfBirth
colony": "
1994-05-06
Lomas",
    "city": "
Villa
Lomas de Alvarez",
    "
countryCode
state": "
MEX
COL",
    "
county
postalCode": "
Colima
99980",
    "
colony
dateOfBirth": "
ADOLFO LOPEZ MATEOS
2000-08-06",
    "
externalNumber
stateOfBirth": "
1007
CDMX",
    "
firstName
email": "
Victoria
lmedina@palo-it.com",
    "
genderCode
firstName": 
2
"Judith",
    "
houseNumber
lastName": "
123
Medina",
    "
ine
maternalLastName": "
1234117890099
Ruiz",
    "
lastName
mobilePhoneNumber": "
Velasco
5521163588",
    "
maritalStatus": 0,
    "maternalLastName
identificationNumber": "
Medina
4152554487415113698",
    "
middleName
ine": "
Valeria
1234117890099",
    "
mobilePhoneIndicator
occupation":
 1,
   
 "
mobilePhoneNumber": "31211635821
Tester",
    "
occupation
genderCode": "
NURSE
1",
    "
ownOrRentResidenceFlag
user4":
 0,
    "postalCode": 54070
"1",
    "
stateOfBirth
identificationNumberFlag": "
DF
2"
}
2 OK: Solicitud exitosa.
4 Bad Request: Request con campos no válidos.
5 Internal Server Error: Servicios no disponibles.
...
UpdateCustomer
Descripción
Request
Response
HTTP Codes
Vincular cuenta al 
Actualizar cliente
 Code Block
{
    "
accountNumber
email": "
9500505675946730065
lmedina@palo-it.com",
  
"alternateCustomer":
  "numberType": 1,
    "customerNumber": "0995000000000077863",
    
{
"address": "Ciruelas",
    "
expirationDate
dateOfBirth": "
2023
1999-
08-22"
  },
02-06",
    "city": "Villa de Alvarez",
    "
customerNumber
countryCode": "
0995000000000075954
MEX",
    "
qualification
county": "
2
CDMX",
    "
customerTypeIndicator
colony":
 0,
 "ADOLFO LOPEZ MATEOS",
    "
foreignUseIndicator
externalNumber":
 0
}
2 OK: Solicitud exitosa.
4 Bad Request: Request con campos no válidos.
5 Internal Server Error: Servicios no disponibles.
Card Gateway
 Info
Permite tener la comunicación entre Spin y Fiserv para los módulos de card.​
POST → /v1/cards/embosser
Descripción
Request
Response
HTTP Codes
Add a new card to account
 "1007",
    "firstName": "Sandra",
    "genderCode": 2,
    "houseNumber": "123",
    "ine": "1234117890099",
    "lastName": "Velasco",
    "maritalStatus": 0,
    "maternalLastName": "Medina",
    "middleName": "Rosa",
    "mobilePhoneIndicator": 1,
    "mobilePhoneNumber": "31211635899",
    "occupation": "NURSE",
    "ownOrRentResidenceFlag": 0,
    "postalCode": 54070,
    "stateOfBirth": "DF"
}
 Code Block
{
    "email": "lmedina@palo-it.com",
    "numberType": 1,
    "customerNumber": "0995000000000077863",
    "address": "Ciruelas",
    "dateOfBirth": "1999-02-06",
    "city": "Villa de Alvarez",
    "countryCode": "MEX",
    "county": "CDMX",
    "colony": "ADOLFO LOPEZ MATEOS",
    "externalNumber": "1007",
    "firstName": "Sandra",
    "genderCode": 2,
    "houseNumber": "123",
    "ine": "1234117890099",
    "lastName": "Velasco",
    "maritalStatus": 0,
    "maternalLastName": "Medina",
    "middleName": "Rosa",
    "mobilePhoneIndicator": 1,
    "mobilePhoneNumber": "31211635899",
    "occupation": "NURSE",
    "ownOrRentResidenceFlag": 0,
    "postalCode": 54070,
    "stateOfBirth": "DF"
}
2 OK: Solicitud exitosa.
4 Bad Request: Request con campos no válidos.
5 Internal Server Error: Servicios no disponibles.
LinkAccountToCustomer
Descripción
Request
Response
HTTP Codes
Vincular cuenta al cliente
 Code Block
{
  "accountNumber": "9500505675946730065",
  "alternateCustomer": 
  {
    "expirationDate": "2023-08-22"
  },
  "customerNumber": "0995000000000075954",
  "qualification": "2",
  "customerTypeIndicator": 0,
  "foreignUseIndicator": 0
}
2 OK: Solicitud exitosa.
4 Bad Request: Request con campos no válidos.
5 Internal Server Error: Servicios no disponibles.
...
Card Gateway
 Info
Permite tener la comunicación entre Spin y Fiserv para los módulos de card.​
POST → /v1/cards/embosser
Descripción
Request
Response
HTTP Codes
Add a new card to account
 Code Block
{
  "addressLine1": "1",
  "addressLine2": "2",
  "assignedSpendingLimits": {
    "maximumSpendingLimit": 3,
    "spendingFrequency": 4,
    "spendingTransaction": 5
  },
  "atmCashAmount": 6,
  "atmCashNumber": 7,
  "atmCashSingleTransactionLimit": 8,
  "authorizationCriteriaTableNumber": "9",
  "authorizationSpendingLimitTable": "10",
  "blockCode": "11",
  "branchNumber": 12,
  "cardAction": 13,
  "cardActionReasonCode": "14",
  "cardDelayDays": 15,
  "panToken": "16",
  "cardSequence": 17,
  "cardholderAffiliationGroupId": "18",
  "cardholderFlag": "19",
  "city": "20",
  "currentCardActivation": "21",
  "customerNumber": "22",
  "deliveryOption": 23,
  "deviceIndicator": "24",
  "embossedName1": "25",
  "embossedName2": "26",
  "enrollmentStatusVBV": "27",
  "expirationDate": "28",
  "firstIssueBranch": 29,
  "internetPurchaseAmount": 30,
  "internetPurchaseNumber": 31,
  "internetPurchaseSingleTransactionLimit": 32,
  "languageCode": "33",
  "maximumAuthorizationFrequency": 34,
  "name1": "35",
  "name1TypeIndicator": 36,
  "name2": "37",
  "name2TypeIndicator": 38,
  "nextCardExpirationDate": "39",
  "numberOfCardsRequested": 40,
  "overTheCounterCashAmount": 42,
  "overTheCounterCashNumber": 43,
  "overTheCounterCashSingleTransactionLimit": 44,
  "pinMailerDelayDays": 45,
  "pinOffset": 46,
  "pinSuppression": 47,
  "plasticId": "48",
  "posServiceCode": 49,
  "accountNumber": "50",
  "postalCode": 51,
  "processType": 52,
  "programId": 53,
  "reissueDeliveryOption": 54,
  "requestedCardType": "55",
  "retailPurchaseAmt": 56,
  "retailPurchaseNumber": 57,
  "retailPurchaseSingleTransactionLimit": 58,
  "securedCodeActivate": 59,
  "stateOrProvince": "60",
  "typeCardMailer": "61",
  "typeOfCard": "62",
  "user1": 63,
  "user2": 64,
  "user3": 65,
  "user4": 66,
  "user5": 67,
  "user6": 68,
  "user7": 69,
  "user8": 70,
  "userDate1": "71",
  "userDate2": "72",
  "vbvPassword": "73",
  "visaMiniIndicator": "74",
  "visaPlusIndicator": "75"
}
POST → /v1/cards/embosser/details
...
Descripción
Request
Response
HTTP Codes
Registro del cliente en la el proveedor de clientes.
 Code Block
{
    "logo": "5060",
    "address": "CirueloCiruelas",
    "houseNumber": "12312345",
    "externalNumber": "10078007",
    "colony": "ResidencialLomas",
    "city": "VillaLomas de Alvarez",
    "state": "COL",
    "postalCode": "2898099980",
    "dateOfBirth": "19942000-0508-06",
    "stateOfBirth": "ColimaCDMX",
    "email": "lmedina@palo-it.com",
    "firstName": "Judith",
    "lastName": "Medina",
    "maternalLastName": "Ruiz",
    "mobilePhoneNumber": "31211635825521163588",
    "identificationNumber": "41525569874151136984152554487415113698",
    "ine": "1234117890099",
    "occupation": "Tester",
    "genderCode": "1",
    "user4":"1",
    "identificationNumberFlag": "2"
}
 Code Block
{
    "logo": "60",
    "address": "Ciruelas",
    "houseNumber": "12345",
    "externalNumber": "8007",
    "colony": "Lomas",
    "city": "Lomas de Alvarez",
    "state": "COL",
    "postalCode": "99980",
    "dateOfBirth": "2000-08-06",
    "stateOfBirth": "CDMX",
    "email": "lmedina@palo-it.com",
    "firstName": "Judith",
    "lastName": "Medina",
    "maternalLastName": "Ruiz",
    "mobilePhoneNumber": "5521163588",
    "identificationNumber": "4152554487415113698",
    "ine": "1234117890099",
    "occupation": "Tester",
    "genderCode": "1",
    "user4":"1",
    "identificationNumberFlag": "2"
}
200: Solicitud exitosa.
400: Request con campos no válidos.
401: Apy Key no válida.
500: Servicios no disponibles.
...
Descripción
Request
Response
HTTP Codes
Actualización de los datos del cliente en el proveedor de clientes.
 Code Block
{
    "email": "lmedina@palo-it.com",
    "numberType": 1,
    "customerNumber": "0995000000000077863",
    "address": "CirueloCiruelas",
    "dateOfBirth": "19941999-0502-06",
    "city": "Villa de Alvarez",
    "countryCode": "MEX",
    "county": "ColimaCDMX",
    "colony": "ADOLFO LOPEZ MATEOS",
    "externalNumber": "1007",
    "firstName": "VictoriaSandra",
    "genderCode": 2,
    "houseNumber": "123",
    "ine": "1234117890099",
    "lastName": "Velasco",
    "maritalStatus": 0,
    "maternalLastName": "Medina",
    "middleName": "ValeriaRosa",
    "mobilePhoneIndicator": 1,
    "mobilePhoneNumber": "3121163582131211635899",
    "occupation": "NURSE",
    "ownOrRentResidenceFlag": 0,
    "postalCode": 54070,
    "stateOfBirth": "DF"
}
 Code Block
{
    "email": "lmedina@palo-it.com",
    "numberType": 1,
    "customerNumber": "0995000000000077863",
    "address": "Ciruelas",
    "dateOfBirth": "1999-02-06",
    "city": "Villa de Alvarez",
    "countryCode": "MEX",
    "county": "CDMX",
    "colony": "ADOLFO LOPEZ MATEOS",
    "externalNumber": "1007",
    "firstName": "Sandra",
    "genderCode": 2,
    "houseNumber": "123",
    "ine": "1234117890099",
    "lastName": "Velasco",
    "maritalStatus": 0,
    "maternalLastName": "Medina",
    "middleName": "Rosa",
    "mobilePhoneIndicator": 1,
    "mobilePhoneNumber": "31211635899",
    "occupation": "NURSE",
    "ownOrRentResidenceFlag": 0,
    "postalCode": 54070,
    "stateOfBirth": "DF"
}
200: Solicitud exitosa.
400: Request con campos no válidos.
401: Apy Key no válida.
500: Servicios no disponibles.
...
Descripción
Request
Response
HTTP Codes
Vinculación del cliente en la cuenta de Spin.
 Code Block
{
    "accountNumber": "95005056759467300650004217470138987703",
    "alternateCustomercustomerNumber": 
  {"0995000000000045698",
    "expirationDatequalification": "2023-08-221",
  },   "customerNumbercustomerTypeIndicator": "0995000000000075954"0,
    "qualificationforeignUseIndicator": "2"0,
    "customerTypeIndicatoralternateCustomer": 0, {
        "foreignUseIndicatorexpirationDate": 0 "2023/12/30"
    }
}
 Code Block
{
    "accountNumber": "0004217470138987703",
    "customerNumber": "0995000000000045698",
    "qualification": "1",
    "customerTypeIndicator": 0,
    "foreignUseIndicator": 0,
    "alternateCustomer": {
        "expirationDate": "2023/12/30"
    }
}
200: Solicitud exitosa.
400: Request con campos no válidos.
401: Apy Key no válida.
500: Servicios no disponibles.
...