Astropay Bank Transfer Withdrawal

Provider Astropay (now Directa24) offers bank transfer withdrawal for various countries in Latin America.

The following method IDs are covered in this section:

IDNameCredit/Debit State
265AstropayBankTransferWithdrawalWithdrawnByProvider

Payment method interaction type: Sychronous execution (see Interaction Types).

Payments are submitted to Directa24 - when being submitted successfully, the state is updated to InitiatedByProvider, else to WithdrawErrorReportedByProvider for an error or to RefusedByProvider for a rejected payment. In the later case, the values ProviderErrorMessage and _ProviderErrorCode_are logged.

Submitted payments are sent by Astropay (D24) to the bank. Once they are confirmed by the bank, Astropay sends a notification to PXP Financial. PXP Financial queries the Astropay (D24) system for the status of the payment and update the payment state on PXP Financial side.

Redirect Integration

Currently not supported.

Backend2BackendIntegration

The following table contains the fields to be sent in the initiatePaymentRequest.specificPaymentAccountData xml section:

key (value type, account type, required)value
CurrencyCode
(string)
currency code, e.g. BRL
BankCountryCode2 (string)country code, e.g. BR
AccountNumber (string)Bank account number
BranchCode (string)bank branch code
BankSortCode (string)Bank code
AccountOwnerAddress (string)Address of bank account owner
AccountOwner (string)Account owner name
AccountType (string)Account type value (see below)

The following parameters can be provided in initiatePaymentRequest.specificPaymentData:

key (value type, account type, required)value
PaymentProviderID
(Int)
Provider ID - default value 152
UserFirstName (string)Beneficiary´s first name
UserLastName (string)Beneficiary´s last name

The following parameters have to passed in initiatePaymentRequest.UserData:

key (value type, account type, required)value
identificationNumber (string)identification number
identificationNumberType (string)identification number type

Overview of required parameters:

FieldArgentinaBrazilChileColumbiaMexicoPeruUruguay
BankSortCodeNAMandatory
(see validations);
send either the bank code or the ISPB
MandatoryMandatory
(see validations)
mandatory only if bank account length is 16 (debit card)NAMandatory
(see validations)
BranchCodeNAMandatory
(see validations)
NANANANAMandatory
(see validations)
AccountNumberMandatory (CBU)
(see validations)
Mandatory
(see validations)
MandatoryMndatoryMandatory (Clabe or Debit card; see validations)Mandatory (CCI)
(see validations)
Mandatory
(see validations)
AccountTypeNAMandatory
(see validations)
Mandatory
(see validations)
Mandatory
(see validations)
NAMandatory
(see validations)
mandatory (only if bank sort code is BROU)
UserFirstNameMandatoryMandatoryMandatoryMandatoryMandotryMandatoryMandatory
UserLastNameNA (optional)MandatoryMandatoryMandatoryMandatoryMandatoryMandatory
IdentificationNumberMandatory
(see validations)
Mandatory
(see validations)
Mandatory
(see validations)
Mandatory
(see validations)
Mandatory
(see validations)
Mandatory
(see validations)
IdentificationNumberTypeNA (optional)NA (optional)NA (optional)Mandatory (see validations)NA
currencyARSBRLCLPCOPMXNPENUYU
Street (in User)NA (optional)NA (optional)NA (optional)MandatoryNA (optional)NA (optional)NA (optional)
eMail (in User)NA (optional)NA (optional)NA (optional)mandatoryNA (optional)NA (optional)NA (optional)

Data Validation

📘

Account Type for Brazil

The AccountType value for Brazil is mandatory. The following values apply:

'1' - For Individual Savings Account - account type 'S' is sent to Astropay
'2'- For Corporate Savings Account - account type 'S' is sent to Astropay
'3' - For Individual Checking Account - account type 'C' is sent to Astropay
'4' - For Corporate Checking Account - account type 'C' is sent to Astropay

Alternatively the values 'C' or 'S' can be passed in the field AccountType for Astropay.

📘

AccountType for other countries

  • Chile: C for checking account, S for savings account and V for vista
  • Columbia: C for checking and S for savings; for Efecty please send accountType S
  • Peru: M (Cuenta Maestra)

📘

Identification Number Validation

  • Brazil:
  • CPF: Length 11; validate verifier-digits
  • CNPJ : Length between 12 and 14; validate verifier-digitals
  • Chile: ID / RUN / RUT: Length 8 or 9
  • Colombia:
  • CC: Numeric. Length between 6 and 10 inclusive
  • NIT: Numeric. Length between 8 and 15
  • CE: Numeric. Length lower than 6 and 10 inclusive
  • PASS: Length between 6 and 10 inclusive
    *CE (for PEP): Numeric. Length 15.
  • Peru:
  • DNI: length between 8 and 9
  • RUC: length 11
  • CE (Carnet Extranjeria): Numeric. Lenght 9
  • PASS (Passport): length 12
  • Mexico: CURP /RFC / IFE / PASS / Residencia: Length between 8 and 18 inclusive
  • Argentina:
  • DNI: Numeric, Length 7-9
  • CUIT/CUIL: Numeric, Length between 7 and 9 inclusive or equal to 11
  • Uruguay:
  • CI: Numeric. Length between 9 and 13 inclusive

Postal Code validations:

CountryRegexExample
Argentina^\d{4}|[A-Za-z]\d{4}([a-zA-Z]{3})?$A1234ABC
Brazil^\d{5}[\s-/]?\d{3}$12345-678
Chile^\d{3}[\s-/]?\d{4}$123-4567
Columbia^\d{5,6}$12345
Mexico^\d{5}$12345
Peru^\d{5}$12345
Uruguay^\d{5}$12345

Bank codes:

Code	Bank name
001	Banco de Chile
016	Banco Credito e Inversiones
053	Banco Ripley
052	Deutsche Bank
054	Radobank Chile
027	Corpbanca
028	Banco Bice
049	Banco Security
031	HSBC Bank
046	ABN Amor Bank Chile
037	Banco Santander- Santiago
057	Banco Paris
507	Banco del Desarrollo
014	Scotiabank Sud Americano
056	Banco Penta
055	Consorcio
012	Banco del Estado de Chile
009	Banco Internacional
039	Banco Itau
051	Banco Falabella
504	BBVA Banco Bhif
Code	Bank name
003	Interbank
800	Caja Metropolitana de Lima
805	Caja Municipal de Ahorro y Crédito Sullana
801	Caja Municipal de Ahorro y Crédito Piura SAC
011	BBVA Continental
002	Banco de Crédito del Perú
808	Caja Municipal de Ahorro y Crédito Huancayo
806	Caja Municipal de Ahorro y Crédito Cuzco
803	Caja Municipal de Ahorro y Crédito Arequipa
802	Caja Municipal de Ahorro y Crédito Trujillo
007	Citibank
054	Banco Falabella
053	Banco GNB Perú S.A.
049	Mi Banco
043	Crediscotia Financiera
038	Banco Interamericano de Finanzas (BIF)
035	Banco Financiero
023	Banco de Comercio
018	Banco de la Nación
009	Scotiabank
056	Santander
Code	Bank name
615	MERRILL LYNCH
623	SKANDIA
622	OACTIN
616	FINAMEX
617	VALMEX
620	PROFUTURO
619	MAPFRE
621	CB ACTINVER
618	UNICA
614	ACCIVAL
140	CONSUBANCO
141	VOLKSWAGEN
143	CIBANCO
166	BANSEFI
168	HIPOTECARIA FEDERAL
145	BBASE
600	MONEXCB
601	GBM
602	MASARI
605	VALUE
606	ESTRUCTURADORES
607	TIBER
608	VECTOR
610	B&B
139	UBS BANK
634	FINCOMUN
646	STP
647	TELECOMM
648	EVERCORE
649	SKANDIA
651	SEGMTY
653	KUSPIT
655	SOFIEXPRESS
656	UNAGRA
659	OPCIONES EMPRESARIALES DEL NOROESTE
670	LIBERTAD
901	CLS
642	REFORMA
640	CB JPMORGAN
638	AKALA
626	CBDEUTSCHE
627	ZURICH
628	ZURICHVI
652	ASEA
629	SU CASITA
630	CB INTERCAM
631	CI BOLSA
632	BULLTICK CB
633	STERLING
636	HDI SEGUROS
637	ORDER
902	INDEVAL
9	BANOBRAS
42	MIFEL
44	SCOTIABANK
58	BANREGIO
59	INVEX
60	BANSI
62	AFIRME
72	BANORTE
102	THE ROYAL BANK
37	INTERACCIONES
36	INBURSA
2	BANAMEX
12	BBVA BANCOMER
14	SANTANDER
19	BANJERCITO
21	HSBC
30	BAJIO
32	IXE
6	BANCOMEXT
103	AMERICAN EXPRESS
106	BAMSA
128	AUTOFIN
129	BARCLAYS
130	COMPARTAMOS
131	BANCO FAMSA
132	BMULTIVA
133	ACTINVER
134	WALMART
135	NAFIN
136	INTERBANCO
137	BANCOPPEL
138	ABC CAPITAL
127	AZTECA
124	DEUTSCHE
108	TOKYO
126	CREDIT SUISSE
110	JP MORGAN
112	BMONEX
113	VE POR MAS
116	ING
001 BANCO DE BOGOTÁ
002 BANCO POPULAR
006 ITAÚ - Antes CORPBANCA
007 BANCOLOMBIA
008 ABN AMRO
009 CITIBANK
010 HSBC
012 BANCO SUDAMERIS
013 BBVA
014 ITAÚ (HELM)
019 BANCO COLPATRIA
023 BANCO DE OCCIDENTE
032 BANCO CAJA SOCIAL BCSC
040 BANCO AGRARIO
051 BANCO DAVIVIENDA
052 BANCO AV VILLAS
058 BANCO PROCREDIT
060 ANCO PICHINCHA
061 BANCOOMEVA
062 BANCO FALABELLA S.A
065 SANTANDER
076 COOPCENTRAL S.A
283 COOPERATIVA FINANCIERA DE ANTIOQUIA
289 COTRAFA COOPERATIVA FINANCIERA
292 CONFIAR
296 FINANCIERA JURISCOOP
1507 NEQUI
1551 DAVIPLATA
Notice that the bank code is not mandatory for Argentina.

Bank name	Code
A.B.N Amro Bank	005
American Express Bank Ltd	295
Bacs Banco de Credito Y Securitizacion	340
Banca Nazionale Del Lavoro	265
Banco B. I. Creditanstalt	147
Banco Banex	297
Banco Bradesco Argentina	336
Banco Cetelem Argentina	331
Banco CMF	319
Banco Cofidis	335
Banco Columbia	389
Banco Comafi	299
Banco Credicoop Coop. L	191
Banco de Corrientes	094
Banco de Formosa	315
Banco de Galicia Y Buenos Aires	007
Banco de Inversion Y Comercio Exterior	300
Banco de La Ciudad de Buenos Aires	029
Banco de La Nacion Argentina	011
Banco de La Pampa Sociedad de Economia M	093
Banco de La Provincia de Buenos A	014
Banco de La Provincia de Cordoba	020
Banco de La Republica Oriental Del Uruguay	269
Banco de San Juan	045
Banco de Santa Cruz	086
Banco de Santiago Del Estero	321
Banco de Servicios Financieros	332
Banco de Servicios Y Transacciones	338
Banco de Valores	198
Banco Del Chubut	083
Banco Del Sol	310
Banco Del Tucuman	060
Banco Do Brasil	046
Banco Empresario de Tucuman Coop. L	137
Banco Finansur	303
Banco Hipotecario	044
Banco Itau Buen Ayre	259
Banco Julio	305
Banco Macro Bansud	285
Banco Mariva	254
Banco Mercurio	293
Banco Meridian	281
Banco Municipal de Ros	065
Banco Patagonia Sudameris	034
Banco Piano	301
Banco Privado de Inversiones	306
Banco Provincia de Tierra Del Fuego	268
Banco Provincia Del Neuquen	097
Banco Regional de Cuyo	079
Banco Rio de La Plata	072
Banco Roela	247
Banco Saenz	277
Banco Societe Generale	027
Bank Of America, National Associa	262
Bankboston, National Associa	015
BBVA Banco Frances	017
Bnp Paribas	266
Citibank	016
Deutsche Bank	325
HSBC Bank Argentina	150
Ing Bank	294
J P Morgan Chase Bank Sucursal Buenos Aires	165
Lloyds Tsb Bank	010
M. B. A. Banco de Inversiones	312
Nuevo Banco Bisel	388
Nuevo Banco de Entre Rios	386
Nuevo Banco de La Rioja	309
Nuevo Banco de Santa Fe	330
Nuevo Banco Del Chaco	311
Nuevo Banco Industrial de Azul	322
Nuevo Banco Suquia	387
Rci Ba	339
The Bank Of Tokyo - Mitsubishi	018
Bank	Code
BANCO ABN AMRO S.A.	075
Cooperativa Central de Crédito Urbano-CECRED	085
BANCO DA AMAZONIA S.A.	003
BANCO DO NORDESTE DO BRASIL S.A.	004
BANCO BONSUCESSO S.A.	218
BANCO BRADESCO S.A.	237
BANCO DO BRASIL S.A.	001
BANCO DE BRASILIA S.A. - BRB	070
CAIXA ECONOMICA FEDERAL - CEF	104
CITIBANK N.A.	477
BANCO COOPERATIVO DO BRASIL S/A - BANCOOB	756
BANCO DAYCOVAL S.A.	707
BANESTES S.A. BANCO DO ESTADO DO ESPIRITO SANTO	021
BANCO DO ESTADO DO PARA S.A. - BANPARA	037
BANCO DO ESTADO DO RIO GRANDE DO SUL S.A. - BANRISUL	041
BANCO DO ESTADO DE SERGIPE S.A. - BANESE	047
HSBC BANK BRASIL S.A. - BANCO MULTIPLO	399
ITAU UNIBANCO S.A.	341
BANCO MERCANTIL DO BRASIL S.A.	389
BANCO MODAL S.A.	746
BANCO SAFRA S.A.	422
BANCO SANTANDER BRASIL S.A.	033
BANCO COOPERATIVO SICREDI S.A.	748
BANCO INTER	077
BANCO SOFISA	637
BANCO NEON	735
NU PAGAMENTOS	260
Cooperativa Central de Crédito Urbano-CECRED	085
BANCO AGIPLAN S.A.	121
Confederação Nacional das Cooperativas Centrais Unicred	136
BANCO ORIGINAL	212
Banco Votorantim S.A.	655
BANCO CITIBANK	745
PagSeguro Internet S.A.	290
BANCO BMG S.A	318
BANCO C6 S.A.	336

Bank account validations Columbia

BankNameBank CodeFormatRegexExample
Nequi1507Customer´s mobile phone^[\s\S]{1,20}$1234567890
Daviplata1551Customer´s mobile phone^[\s\S]{1,20}$
Efecty10003
Others-Numeric^\d{8,19}$1234567890123

Branch code (Brazil):

BankFormatExample
ABN AmroFormat: XXXX where X are digits. The number of digits can't exceed 51234
Banco do BrasilNot permitted values: 001, 051. Format: XXXX-D or XXXXD where X are digits and D are digits or a 'X'. The number of digits may change, but can't exceed 5 digits12345, 1234-5, 1234-X, 1234X
SantanderNot permitted values: 033. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits12345, 1234-5
ItauNot permitted values: 001, 341, 500. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits12345, 1234-5
CaixaNot permitted values: 013, 023, 104. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits12345, 1234-5
BradescoNot permitted values: 237. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits12345, 1234-5
OthersFormat: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits12345, 1234-5

Requests/Responses

Example initiatePaymentRequest:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <merchantID>B2BTestMerchant</merchantID>
  <shopID>AstropayCardBankTransferWithdrawalShop</shopID>
  <merchantTransactionID>5f366a56-a394-4ab2-aac3-f4174ba716d8-21</merchantTransactionID>
  <paymentMethodID>265</paymentMethodID>
  <amount currencyCode="BRL">10.01</amount>
  <userID>12eadca3-0d87-4144-a75e-10ea70</userID>
  <userData>
    <username>061bb617-bbe8-4aa4-b896-8b06949e653b</username>
    <firstname>Edson</firstname>
    <lastname>Arantes do Nascimento</lastname>
    <currencyCode xsi:nil="true" />
    <languageCode xsi:nil="true" />
    <email xsi:nil="true" />
    <address>
      <street>Street</street>
      <houseName xsi:nil="true" />
      <houseNumber>1</houseNumber>
      <houseNumberExtension xsi:nil="true" />
      <postalCode>11300</postalCode>
      <city>Sao Paulo</city>
      <state xsi:nil="true" />
      <countryCode2>BR</countryCode2>
      <telephoneNumber>099123456</telephoneNumber>
    </address>
    <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
    <identificationNumber>1234567890</identificationNumber>
    <identificationNumberType>1</identificationNumberType>
  </userData>
  <userIP>127.0.0.1</userIP>
  <userSessionID>a59a22cd-6178-4125-b966-188ff1a61181</userSessionID>
  <creationTypeID>1</creationTypeID>
  <specificPaymentData>
    <data xsi:type="keyStringValuePair">
      <key>UserFirstname</key>
      <value>John</value>
    </data>
    <data xsi:type="keyStringValuePair">
      <key>UserLastname</key>
      <value>Doe</value>
    </data>
    <data xsi:type="keyIntValuePair">
      <key>PaymentProviderID</key>
      <value>152</value>
    </data>
  </specificPaymentData>
  <paymentAccount>
    <specificPaymentAccountData>
      <data xsi:type="keyStringValuePair">
        <key>CurrencyCode</key>
        <value>BRL</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>BankCountryCode2</key>
        <value>BR</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountNumber</key>
        <value>88365484</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>BranchCode</key>
        <value>7197</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountOwner</key>
        <value>Edson Arantes do Nascimento</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>BankSortCode</key>
        <value>033</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountOwnerAddress</key>
        <value>1225 Bonavita St.</value>
      </data>
      <data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>1</value>
      </data>
    </specificPaymentAccountData>
  </paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<merchantID>YourShop</merchantID>
	<shopID>YourMerchant</shopID>
	<merchantTransactionID>59715590-9</merchantTransactionID>
	<paymentMethodID>265</paymentMethodID>
	<amount currencyCode="MXN">1.00</amount>
	<userID>ygtest</userID>
	<userData>
		<username>ygtest</username>
		<firstname>John</firstname>
		<lastname>Doe</lastname>
		<email>[email protected]</email>
		<address>
			<countryCode2>MX</countryCode2>
		</address>
		<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
	</userData>
	<userIP>179.108.166.2</userIP>
	<userSessionID>59715590</userSessionID>
	<creationTypeID>1</creationTypeID>
	<specificPaymentData>
		<data xsi:type="keyIntValuePair">
			<key>PaymentProviderID</key>
			<value>152</value>
		</data>
	</specificPaymentData>
	<paymentAccount>
		<specificPaymentAccountData>
			<data xsi:type="keyStringValuePair">                                                 
				<key>BankName</key>
				<value>Banco do Brasil</value>
			</data>
			<data xsi:type="keyStringValuePair">                                                 
				<key>BankCountryCode2</key>
				<value>MX</value>
			</data>
			<data xsi:type="keyStringValuePair">                                               
				<key>AccountNumber</key>                                                
				<value>032180000118359719</value>
			</data>
			<data xsi:type="keyStringValuePair">                                                 
				<key>AccountOwner</key>
				<value>DOS SANTOS</value>
			</data>
			<data xsi:type="keyStringValuePair">                                                 
				<key>BankSortCode</key>
				<value>032</value>
			</data>
		</specificPaymentAccountData>
	</paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <merchantTransactionID>59715590-11-27</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="PEN">100.00</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Yusuf</firstname>
             <lastname>Genc</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>PE</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
              <identificationNumber>58324956</identificationNumber>
               <identificationNumberType>DNI</identificationNumberType>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco do Peru</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>PE</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>00159687395013948567</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>113</value>
   </data>
   	<data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>C</value>
      </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <merchantTransactionID>59715590-11-42</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="PEN">100.00</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Yusuf</firstname>
             <lastname>Genc</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>PE</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
              <identificationNumber>10583249562</identificationNumber>
               <identificationNumberType>RUC</identificationNumberType>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco do Peru</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>PE</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>00159687395013948567</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>113</value>
   </data>
   	<data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>C</value>
      </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <merchantTransactionID>59715590-1-06</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="CLP">1.00</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Max</firstname>
             <lastname>Muster</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>CL</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
             <identificationNumber>21644285</identificationNumber>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco de Chile</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>CL</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>9795493</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>001</value>
   </data>
	<data xsi:type="keyStringValuePair">
        <key>AccountType</key>
        <value>C</value>
      </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <merchantTransactionID>59715590-12-11-313</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="COP">1000</amount>
        <userID>ygtest_SBCOM_BRL</userID>
        <userData>
             <username>ygtest_SBCOM_BRL</username>
             <firstname>Yusuf</firstname>
             <lastname>Genc</lastname>
             <email>[email protected]</email>
             <address>
             	<countryCode2>CO</countryCode2>
             </address>
             <dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
              <identificationNumber>1058324956</identificationNumber>
              <identificationNumberType>CC</identificationNumberType>
        </userData>
         <userIP>179.108.166.2</userIP>
        <userSessionID>59715590</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
  <data xsi:type="keyIntValuePair">
   <key>PaymentProviderID</key>
   <value>152</value>
  </data>
 </specificPaymentData>
 <paymentAccount>
  <specificPaymentAccountData>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankName</key>
    <value>Banco de Bogota</value>
   </data>
    <data xsi:type="keyStringValuePair">                                                 
    <key>BankCountryCode2</key>
    <value>CO</value>
   </data>
   <data xsi:type="keyStringValuePair">                                               
    <key>AccountNumber</key>                                                
    <value>0321800001183597</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>AccountOwner</key>
    <value>DOS SANTOS</value>
   </data>
   <data xsi:type="keyStringValuePair">                                                 
    <key>BankSortCode</key>
    <value>001</value>
   </data>
  </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest>

<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <merchantTransactionID>hctest002013514</merchantTransactionID>
        <paymentMethodID>265</paymentMethodID>
        <amount currencyCode="COP">40000</amount>
        <userID>55517534-03</userID>
        <userData>
                                <username>pp_ppboleto7-03</username>
                <firstname>PPPPBOLETOFN</firstname>
                <lastname>PPPPBOLETOLN</lastname>
                <email>[email protected]</email>
                <address>
                        <street>Address</street>
                        <houseName>Address</houseName>
                        <postalCode>447475</postalCode>
                        <state>State</state>
                        <countryCode2>CO</countryCode2>
                        <telephoneNumber>+573104028587</telephoneNumber>
                </address>
                        <dateOfBirth>1940-03-08T00:00:00</dateOfBirth>
                         <identificationNumber>2134567890</identificationNumber>
                        <identificationNumberType>CC</identificationNumberType>
        </userData>

        <userIP>10.8.60.57</userIP>
        <userSessionID>53603061</userSessionID>
        <creationTypeID>1</creationTypeID>
        <specificPaymentData>
                <data xsi:type="keyStringValuePair">
                        <key>UserFirstname</key>
                        <value>PPPPBOLETOFN</value>
                </data>
                <data xsi:type="keyStringValuePair">
                        <key>UserLastname</key>
                        <value>PPPPBOLETOLN</value>
                </data>
                <data xsi:type="keyStringValuePair">
                        <key>UserCountryCode2</key>
                        <value>CO</value>
                </data>
                <data xsi:type="keyIntValuePair">
                        <key>PaymentProviderID</key>
                        <value>152</value>
                </data>
        </specificPaymentData>
        <paymentAccount>
                <specificPaymentAccountData>
                <data xsi:type="keyStringValuePair">
                <key>CurrencyCode</key>
                <value>COP</value>
               </data> 

			<data xsi:type="keyStringValuePair">
                        <key>BankCountryCode2</key>
                        <value>CO</value>
                        </data>
                        <data xsi:type="keyStringValuePair">
                                <key>BankSortCode</key>
                                <value>10003</value>
                        </data>
                         <data xsi:type="keyStringValuePair">
                                <key>AccountType</key>
                                <value>S</value> 
                        </data>
            </specificPaymentAccountData>
        </paymentAccount>
</initiatePaymentRequest> 
 
 

Example initiatePaymentResponse:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>B2BTestMerchant</merchantID>
        <shopID>AstropayCardBankTransferWithdrawalShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>5f366a56-a394-4ab2-aac3-f4174ba716d8-21</merchantTransactionID>
        <paymentID>cf976b7d-3711-441d-b38a-5f8c6a6becd1</paymentID>
        <userID>12eadca3-0d87-4144-a75e-10ea70</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="BRL">10.01</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>60425692-feae-47bb-b699-7b4ae6081c23</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2017-11-09T08:43:33.7735125Z</createdOn>
            <description>OK</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">2.66</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>UserFirstname</key>
                <value>John</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>UserLastname</key>
                <value>Doe</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>cf976b7d-3711-441d-b38a-5f8c6a6becd1</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>e9d14450-20db-4304-b55d-a652953f7976</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>541885ca-1f5b-4f16-be70-62cd9cb973a5</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-9</merchantTransactionID>
        <paymentID>f9b6a33c-831e-4f37-b533-3fc6f6db70da</paymentID>
        <userID>ygtest</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="MXN">1.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>cefcf293-2583-4962-9720-50de184fd70f</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-01T15:34:48.2705465Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">0.06</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2257</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25161</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>e67a3016-a5cb-4986-8210-1d39a68d5943</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-11-27</merchantTransactionID>
        <paymentID>d3f26f44-e30e-4741-a819-853e97be0dfa</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="PEN">100.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>bd938504-0c97-486b-a9e2-bfe91a3784c4</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-02T14:53:55.7424819Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">24.94</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2281</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25185</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchamt</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-11-42</merchantTransactionID>
        <paymentID>98858d51-cc27-49e1-a036-505bf89f137f</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="PEN">100.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>9122d0e4-b161-4474-934b-bc3ebbfa29ff</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-05T09:54:08.7735183Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">24.94</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2288</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25213</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>YourMerchant</merchantID>
        <shopID>YourShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-11-42</merchantTransactionID>
        <paymentID>98858d51-cc27-49e1-a036-505bf89f137f</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="PEN">100.00</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>9122d0e4-b161-4474-934b-bc3ebbfa29ff</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2018-02-05T09:54:08.7735183Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">24.94</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>2288</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>25213</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>PG</merchantID>
        <shopID>releaseb</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>59715590-12-11-313</merchantTransactionID>
        <paymentID>b58e1f0a-bde7-4f1e-aad2-4f49ad6331d2</paymentID>
        <userID>ygtest_SBCOM_BRL</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="COP">1000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>179.108.166.2</userIP>
        <state>
            <id>d049f140-1b0e-4c0f-933c-930986d291fd</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2020-01-28T08:27:18.6162134Z</createdOn>
            <description>OK</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">0.39</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>52716f7e-53bb-436a-a547-872e8edf045c</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>3458</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>ba49550b-2769-4ef3-ad1c-e9f04e347f1f</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>DemoMerchant</merchantID>
        <shopID>DemoShop</shopID>
        <paymentMethod>
            <key>265</key>
            <value>AstropayBankTransferWithdrawal</value>
        </paymentMethod>
        <merchantTransactionID>hctest002013514</merchantTransactionID>
        <paymentID>0b1129d1-d3fb-45c6-8545-3c933fdc594f</paymentID>
        <userID>55517534-03</userID>
        <paymentProvider>
            <key>152</key>
            <value>Astropay</value>
        </paymentProvider>
        <amount currencyCode="COP">40000</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>10.8.60.57</userIP>
        <state>
            <id>a1f9404e-2007-4dbc-80a8-2258eee49c51</id>
            <definition>
                <key>3</key>
                <value>InitiatedByProvider</value>
            </definition>
            <createdOn>2024-01-03T09:12:13.9357329Z</createdOn>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseMessage</key>
                    <value>OK</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">15.42</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>UserFirstname</key>
                <value>PPPPBOLETOFN</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>UserLastname</key>
                <value>PPPPBOLETOLN</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>244402</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>20672</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>e4ab9ba8-bb4c-4e92-a5be-f6a5b5206c3e</paymentAccountID>
        </paymentAccount>
    </payment>
</initiatePaymentResponse>

The payment can reach one of the following states in the initiatePaymentResponse:

Payment StatesDescription
InitiatedByProviderIntermediate state denoting a successful payment submission at provider
WithdrawalErrorReportedByProviderError state due to failed payment submission at provider; errors are logged in the PaymentStateAdditionalDetails fields ProviderErrorCode and ProviderErrorMessage
RefusedByProviderError state for a rejected payment; errors are logged in the PaymentStateAdditionalDetails field ProviderReturnCode

Submitted payments are sent by Astropay to the bank. Once they are confirmed by the bank, Astropay sends a notification to PXP Financial. PXP Financial queries the Astropay system for the status of the payment and update the payment state on PXP Financial side.

An AstropayBankTransferWithdrawal payment will have the following flow (described in provider terms and PXP Financial payment service states):

Pending (state InitiatedByProvider) => Delivered (state PendingOnProvider) => Confirmed (state WithdrawnByProvider) or Rejected (state RefusedByProvider).

A payment can also go from Pending (state InitiatedByProvider) or Delivered (state PendingOnProvider) to Cancelled (state Cancelled).

Payment StatesDescription
PendingOnProviderA withdrawal payment has been sent to provider ("Delivered"), but not yet processed and it still can be rejected
WithdrawnByProviderSuccess state
RefusedByProviderError state due to failed processing of payment; errors are logged in the PaymentStateAdditionalDetails fields ProviderErrorCode and ProviderErrorMessage
QueryPaymentStateErrorReportedByProviderWhen PXP Financial receives a state change notification from provider Astropay, the state of the payment is being queried against provider. When an error occurs, errors are logged in the PaymentStateAdditionalDetails fields ProviderErrorCode and ProviderErrorMessage

Notifications

The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.

Example handlePaymentStateChangedNotificationRequest:

<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
  <payment xsi:type="paymentWithPaymentAccount">
    <merchantID>B2BTestMerchant</merchantID>
    <shopID>AstropayCardBankTransferWithdrawalShop</shopID>
    <paymentMethod>
      <key>265</key>
      <value>AstropayBankTransferWithdrawal</value>
    </paymentMethod>
    <merchantTransactionID>17593196-f44f-4b1e-92e8-474d8e88710d</merchantTransactionID>
    <paymentID>c2c83321-1466-4af7-bde3-d84418f9b991</paymentID>
    <userID>12b140b5-35ee-4a83-9f87-9d4405</userID>
    <paymentProvider>
      <key>152</key>
      <value>Astropay</value>
    </paymentProvider>
    <amount currencyCode="BRL">10.0000</amount>
    <creationType>
      <key>1</key>
      <value>User</value>
    </creationType>
    <userIP>127.0.0.1</userIP>
    <state>
      <id>6ca51370-bac8-42da-8121-1627a34289cd</id>
      <definition>
        <key>20</key>
        <value>WithdrawnByProvider</value>
      </definition>
      <createdOn>2017-09-08T09:58:29.783</createdOn>
      <paymentStateDetails>
        <detail xsi:type="keyStringValuePair">
          <key>ProviderResponseMessage</key>
          <value>Completed</value>
        </detail>
      </paymentStateDetails>
    </state>
    <isExecuted>true</isExecuted>
    <baseAmount currencyCode="EUR">2.6500</baseAmount>
    <paymentDetails>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderExternalID</key>
        <value>c2c83321-1466-4af7-bde3-d84418f9b991</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>BankReferenceID</key>
        <value>513512.04198.5</value>
      </detail>
      <detail xsi:type="keyStringValuePair">
        <key>ProviderTransactionID</key>
        <value>8ef0c159-966e-43e1-a0ba-62661d72fc47</value>
      </detail>
    </paymentDetails>
    <paymentAccount>
      <paymentAccountID>d52b9f0e-55b3-4011-a5e7-3935c6388958</paymentAccountID>
    </paymentAccount>
  </payment>
</handlePaymentStateChangedNotificationRequest>

Testing instructions

Identification Numbers for Astropay

CountryIdentificationNumber (sample values for testing)IdentifcationNumberType
BrazilTest data for CPF or CNPJ hereDo not send any value.
ChileTest data for RUT here (11 digits)Do not send any value
PeruDNI: 58324956
RUC: 48531120453
PASS: 595601234865
CE: 433450978123
Send DNI, RUC, PASS or CE.
Mexicosending is optional
CURP or RFC or IFE number
sending is optional
ColumbiaFor CC eg. 1058324956type CC.

Bank account data for Astropay:

CountryAccountNumberBranchCodeBankSortCodeAccountType
Brazil883654847197C
Chile9795493001C
Peru00159687395013948567113C
Mexico032180000118359719032-
Columbia0321800001183597001

BankTransferWithdrawalReturn

In case a bank transfer withdrawal is returned, then a new payment of type BankTransferWithdrawalReturn is created and merchant is notified.

Sample notification with payment method BankTransferWithdrawal

<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
	<payment xsi:type="paymentWithPaymentAccount">
		<merchantID>xxx</merchantID>
		<shopID>xxx</shopID>
		<paymentMethod>
			<key>265</key>
			<value>AstropayBankTransferWithdrawal</value>
		</paymentMethod>
		<merchantTransactionID>e2934084-ce2d-4d57-bd0f-81a0983fbf49</merchantTransactionID>
		<paymentID>de6524a5-44c8-440e-8fb9-bda0ccf59301</paymentID>
		<userID>f782088e-0d3e-402b-9143-359be4</userID>
		<paymentProvider>
			<key>152</key>
			<value>Astropay</value>
		</paymentProvider>
		<amount currencyCode="BRL">10.0300</amount>
		<creationType>
			<key>1</key>
			<value>User</value>
		</creationType>
		<state>
			<id>434bae34-630a-4b6f-9c00-faa0c5c5adf2</id>
			<definition>
				<key>279</key>
				<value>ReturnedByProvider</value>
			</definition>
			<createdOn>2021-04-07T15:40:31.79</createdOn>
			<paymentStateDetails>
				<detail xsi:type="keyStringValuePair">
					<key>ProviderResponseMessage</key>
					<value>Rejected</value>
				</detail>
			</paymentStateDetails>
		</state>
		<isExecuted>true</isExecuted>
		<baseAmount currencyCode="EUR">2.6600</baseAmount>
		<paymentDetails>
			<detail xsi:type="keyStringValuePair">
				<key>ProviderExternalID</key>
				<value>de6524a5-44c8-440e-8fb9-bda0ccf59301</value>
			</detail>
			<detail xsi:type="keyIntValuePair">
				<key>MerchantSettlementCurrencyID</key>
				<value>2</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentID</key>
				<value>de6524a5-44c8-440e-8fb9-bda0ccf59301</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentMerchantTransactionID</key>
				<value>e2934084-ce2d-4d57-bd0f-81a0983fbf49</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentMethodID</key>
				<value>265</value>
			</detail>
			<detail xsi:type="keyStringValuePair">
				<key>OriginalPaymentMethodName</key>
				<value>AstropayBankTransferWithdrawal</value>
			</detail>
		</paymentDetails>
		<paymentAccount>
			<paymentAccountID>1d9ca158-38ce-4270-8d53-cbab137254df</paymentAccountID>
		</paymentAccount>
	</payment>
</handlePaymentStateChangedNotificationRequest>